Add Simplified Chinese translation of a_tour_of_sage and tutorial #39792
Conversation
|
There already was a translation to Chinese (I think simplified) of some parts of the introduction to SageMath: #9577, #12559. The problem why they were not merged was technical with the documentation not building properly (I think only in the pdf doc) IIRC. This might still be an issue that needs to be addressed. |
Thank you @tscrim . I am able to successfully generate HTML documents on my local machine. Now, I will focus on resolving the problem where simplified Chinese documents fail to convert to PDF format correctly. |
|
Hi, @tscrim I think I have fixed the problem where simplified Chinese documents fail to convert to PDF. The attachment contains a Simplified Chinese PDF document of a_tour_of_sage that I generated locally. |
|
Documentation preview for this PR (built with commit bf25803; changes) is ready! 🎉 |
2. Add new documents to website/root_index.html,
|
Can I ask one other thing? You don't need to do this in order to get a positive review, but this seems like a good place to do it. Could you also merge in the translation of the tutorial #9577 into your PR? You can find instructions how to get the old branch here. |
|
it seems to me that the CI is running lualatex rather than xelatex, and this might explain Is it possible/easy to change? |
|
here is the actual error: found in downloaded log archives (in CI you can click the cogwheel next to "search logs" in the upper right corner) |
|
@dimpase Thanks. Somehow before when I searched for "LateX Error" online it didn't find that part. Hopefully switching to lualatex will fix the problem. @fisheryv For some reason our release manager did a force-push of your branch with an updated version of Sage. Not sure why. Well, I would ignore that and do a force-push with your local branch with the changes @dimpase and I are suggesting. |
|
note that --- a/build/pkgs/texlive/distros/debian.txt
+++ b/build/pkgs/texlive/distros/debian.txt
@@ -21,3 +21,4 @@ texlive-lang-japanese
texlive-lang-polish
texlive-lang-portuguese
texlive-lang-spanish
+texlive-lang-chineseto make sure it's installed. (I think) To be completely correct, similar changes should happen to all |
@tscrim I merged in the translation of the tutorial. Since #9577 is very outdated, I have re-translated and refined it based on the latest version. |
Based on the error message above, the issue lies in the system not being able to find the tlmgr install ctex to install the CTEX package should resolve the issue. @dimpase 's comments greatly inspired me, and I added Chinese language support in texlive/distros and included the |
|
The branch is currently messed up, though. One needs to resolve the merge conflicts - which, I think, are a fallout of an unfortunate push by our release manager, @vbraun, few days ago. Volker, do you have an advice how to fix these easily? |
|
I'm happy to approve a CI run once the conflicts are resolved. |
# Conflicts: # CITATION.cff # VERSION.txt # build/pkgs/configure/checksums.ini # build/pkgs/configure/package-version.txt # build/pkgs/sage_conf/version_requirements.txt # build/pkgs/sage_docbuild/version_requirements.txt # build/pkgs/sage_setup/version_requirements.txt # build/pkgs/sage_sws2rst/version_requirements.txt # build/pkgs/sagelib/version_requirements.txt # build/pkgs/sagemath_bliss/version_requirements.txt # build/pkgs/sagemath_categories/version_requirements.txt # build/pkgs/sagemath_coxeter3/version_requirements.txt # build/pkgs/sagemath_environment/version_requirements.txt # build/pkgs/sagemath_mcqd/version_requirements.txt # build/pkgs/sagemath_meataxe/version_requirements.txt # build/pkgs/sagemath_objects/version_requirements.txt # build/pkgs/sagemath_repl/version_requirements.txt # build/pkgs/sagemath_sirocco/version_requirements.txt # build/pkgs/sagemath_tdlib/version_requirements.txt # pkgs/sage-conf/VERSION.txt # pkgs/sage-conf_conda/VERSION.txt # pkgs/sage-conf_pypi/VERSION.txt # pkgs/sage-docbuild/VERSION.txt # pkgs/sage-setup/VERSION.txt # pkgs/sage-sws2rst/VERSION.txt # pkgs/sagemath-bliss/VERSION.txt # pkgs/sagemath-categories/VERSION.txt # pkgs/sagemath-coxeter3/VERSION.txt # pkgs/sagemath-environment/VERSION.txt # pkgs/sagemath-mcqd/VERSION.txt # pkgs/sagemath-meataxe/VERSION.txt # pkgs/sagemath-objects/VERSION.txt # pkgs/sagemath-repl/VERSION.txt # pkgs/sagemath-sirocco/VERSION.txt # pkgs/sagemath-tdlib/VERSION.txt # src/VERSION.txt # src/bin/sage-version.sh # src/sage/version.py
Hi, @roed314 |
|
This time the
I think this is most likely caused by system environment issues rather than the code itself. Could you provide some information or suggestions? @dimpase @roed314 @tscrim |
|
I don't know how to fix this. Perhaps adding Chinese fonts for pdf building resulted in the space being exhausted. |
…ted during the CI Linux incremental process: ``` make[2]: ./tools/test-git-no-uncommitted-changes: No such file or directory make[2]: *** [Makefile:257: test-git-no-uncommitted-changes] Error 127 ```
|
I‘ve got the following error report during the CI Linux incremental process: I think we should add the |
|
Updating CI docker images happens in a way I don't know. Perhaps @tobiasdiez can comment. |
|
I have extracted from https://github.com/sagemath/sage/actions/runs/14353554953/job/40301833433?pr=39792 I think this can be set to positive review? Or do we want a native speaker to have a go? I can ask one of my former students to help. |
eventual improvements are forthcoming in a few days. |
|
that's what I received. I think this is good to go I went through the first 5 pages of the text carefully, and then the first 30 pages less carefully. The language used is a bit informal for a documentation and/or textbook but is otherwise easy to read and understand. It is clear that this text is translated from English into Chinese, as the sentence structure is clearly English instead of Chinese. Thus a reader who only knows Mandarin but not English might find it amusing to read but will still understand what is written. Overall, this is a good translation and will achieve the goal of helping Chinese-speaking people who are interested in Sage but is not fluent in English. The reader still needs to know a very minimal amount of English, but considering the target audiences, this requirement will probably be met by most readers. |
I really appreciate it. As a mathematics major, my literature skills are somewhat limited. In future translations, I will pay closer attention to the differences between the two languages and strive to strike a better balance between translation accuracy and fluency. |
|
the review is by a maths prof., who grew up in Indonesia speaking Hokkein, Malay (Indonesian version), Mandarin, English - in some order :-) |
I majored in applied mathematics and statistics and I'm from Hong Kong. After carefully reviewing these two documents (particularly sage_tutorial.pdf), I think the translation to be of high quality overall. The mathematical terminology is accurately translated, and the language flows naturally in Chinese. The translator skillfully adapted the sentence structure rather than rigidly adhering to the English word order, enhancing readability. One minor suggestion: For specialized terms, it would be best to retain the original English vocabulary. @fisheryv |
|
Let's merge this, and do further edits on a subsequent PR |
|
merge conflict, please fix |
I've merged upstream branch 'develop', no more conflictions. |
Sagemath has long been without Simplified Chinese translations for its tutorials, which I believe significantly hinders the use and spread of SageMath. Therefore, I've decided to initiate a project to translate all tutorials into Simplified Chinese, striving for the translations to be faithful, fluent, and elegant. Here is the Simplified Chinese translation of a_tour_of_sage and sage_tutorial.
📝 Checklist