From nobody Sat Oct 22 18:17:46 2022 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4MvqLz19wSz4fPC0 for ; Sat, 22 Oct 2022 18:17:47 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MvqLy5WrFz4CQb for ; Sat, 22 Oct 2022 18:17:46 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4MvqLy4XslzdfH for ; Sat, 22 Oct 2022 18:17:46 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 29MIHkk8099878 for ; Sat, 22 Oct 2022 18:17:46 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 29MIHkjU099876 for doc@FreeBSD.org; Sat, 22 Oct 2022 18:17:46 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 267274] Please remove the zh-CN Handbook of the current FreeBSD website Date: Sat, 22 Oct 2022 18:17:46 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Books & Articles X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: yklaxds@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1666462666; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Ue2bxjgxUixY7cTOlDUsy5O1OrnTiJi+acixQxrLy7I=; b=kGY09RucTHLo7YdELwFQCrTBmSi64+GAPCiuD7bfjMCMVZ80XR+b0/dQxkRGZStiaRZlnc rzA3uQrZEolFAgd5l0UmaHFRocjVe/YkE00aV/mTbLqmV314iLL8J2lT4WV2RSelguDoox pyAN5qy1ubVhFliqU8A1os7gT74ZqWaLXuyyZKqbs0a5Yrl3BVuBlHfPq8hV9mdSmQajHu vQk9RrBt0C4hx3O7AF1Ccd+sGFo6BcvUWzOMch39Ngw7WhKpuPSf2SSeAzXCKSJLbh4CfI v9e6hvsgBN2wFAWkCedzlkZFqeJKtD7+qpwglr4lhpIHbX+zKMhFqyAIgNjl3g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1666462666; a=rsa-sha256; cv=none; b=IBzGFtDHfT07tyOXk1FQrNBjmudJ1ld/tRSKeXNx2nORMki7uJ85mQGAY3JSfY+JBO2vl0 M469vCebjPgDuhwC0k7rw+SUvxocMUPfSnUbnjA19zUCHp0jtBZFSMNRwZ8s9jkmp0t8c8 Gexhqj8efKKN9mfe3gtOiKZ+wP5hL4oUhOX5RxjiWJX4LO1RTKldygYTVq52WYjRe7enH4 dDXDQaSXDa2jBcqo1pUPf3haxltQTAJtHC/fjriwhn1OHcR6CG8duGnotI8VSzXniPuF0A PA8T46OeGSMf4WmA+tX653+cj0YcsPLAx3BQrmZtVwd2N3SkBNdOADcLo+Dpdg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D267274 Bug ID: 267274 Summary: Please remove the zh-CN Handbook of the current FreeBSD website Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Only Me Priority: --- Component: Books & Articles Assignee: doc@FreeBSD.org Reporter: yklaxds@gmail.com The simplified Chinese translation of the handbook on the FreeBSD website is now about a decade out of date overall: https://docs.freebsd.org/zh-cn/books/handbook/=20 Outdated articles often give many misconceptions to newcomers to FreeBSD th= at the development of FreeBSD has stalled. The overall structure of the Handbook is all wrong. Also, I was unable to participate in the translation of the FreeBSD documentation group because i= ts translation schedule was 100% - because the old documentation was not completely removed. Small fixes are no longer useful and we have to start translating the Handbook from scratch. The documentation and websites in FreeBSD now use the AsciiDoc syntax, so if you want to translate it you have to use a command to convert it to a .po f= ile and then use software like poedit to translate it. There are many problems = with this step. Many of us don't know AsciiDoc syntax, only simple Markdown synt= ax. The .po file cannot determine exactly what changes have been made upstream,= on which lines and in which characters. If several paragraphs in the document = were completely removed upstream of FreeBSD and several different paragraphs were added, then the problem would be even greater and the entire paragraph woul= d be misplaced. And generating .po files for three dozen files at a time is tedi= ous and painful - I've done it more than once when I've tried to translate Free= BSD websites, and there are even thousands of .po files in there that need to be generated manually. Even if there were a script that could generate them on= e by one, it would be difficult to determine the scope of the changes and what exactly they were. For Chinese, some of the English changes are meaningless, meaning that the tense or singular and plural are not represented by indivi= dual words, but by the whole sentence. I understand that this is necessary but it does not help our translation. I tried to use poedit to translate, but I so= on realized that it was unrealistic, that it didn't show me the changes I had = made in real-time, that I didn't know where the errors were, that it was a paywa= re program and I had paid for it, but the author of poedit told me that I was making a lot of money with his program because he had seen me translate more strings than he had expected with his program But the truth is that I make a lot of money from it every time I open it. But the truth is that every time= I open this software, it starts to translate automatically. The changes I made to it were to translate the Handbook into Simplified Chi= nese into Markdown syntax, keeping it as close to AsciiDoc syntax as possible. I also deployed it to the server using vuepress and GitHub. The PDF export function is also supported. This way, even those who do not have access to GitHub can forward their translations to me via text files. Markdown syntax= is easy to learn and can be mastered in five minutes, as there is no need to master complex syntax such as HTML nesting, which is barely covered in the article. Also, as far as updates go, just create a new GitHub repository for only the Handbook adoc files upstream of FreeBSD. After some time (usually a month), then delete the original content and put it in the new adoc file, a= nd GitHub will automatically show the difference between the two. You can then compare the changes.=20 Simplified Chinese translations of documents are now deployed in https://handbook.bsdcn.org/ . The documentation is located at https://github.com/FreeBSD-Ask/Handbook . The source code for the Document Deployment website is located at https://github.com/FreeBSD-Ask/Handbook-Next In summary, please consider removing the now obsolete Handbook from the Fre= eBSD website.And, if possible, can it be linked to https://handbook.bsdcn.org/ ? --=20 You are receiving this mail because: You are the assignee for the bug.=