Hello, I explore the project Blender Manual Translate. At this point I have a small problem.
https://docs.blender.org/manual/de/dev/contribute/build.html
After typing “make” the terminal says:
Set the SPHINXBUILD environment variable to point to the full path of the ‘sphinx-build’ executable. Alternatively you can add the directory with the executable to your PATH.
The OS is macOS 12.6.6
Is this actually the problem?
If so, what characters do I have to enter where?
Thanks for answers
Andreas
Hi Andreas,
did you follow all the steps from Installation unter macOS — Blender Manual ?
This is what the terminal says:
Last login: Mon Jun 12 16:00:39 on console
agk@iMac-von-AGK ~ % python --version
Python 3.9.6
agk@iMac-von-AGK ~ % python -m pip --version
pip 21.2.4 from /Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.9/lib/python3.9/site-packages/pip (python 3.9)
agk@iMac-von-AGK ~ %
agk@iMac-von-AGK ~ % brew install git
Running brew update --auto-update…
Warning: git 2.41.0 is already installed and up-to-date.
To reinstall 2.41.0, run:
brew reinstall git
agk@iMac-von-AGK ~ % git lfs install
Git LFS initialized.
agk@iMac-von-AGK ~ %
or so:
agk@iMac-von-AGK ~ % brew install git-lfs
==> Downloading https://formulae.brew.sh/api/formula.jws.json
######################################################################### 100.0%
==> Downloading https://formulae.brew.sh/api/cask.jws.json
######################################################################### 100.0%
Warning: git-lfs 3.3.0 is already installed and up-to-date.
To reinstall 3.3.0, run:
brew reinstall git-lfs
agk@iMac-von-AGK ~ %
Did you also run pip install -r requirements.txt?
I think, but now I got this:
agk@iMac-von-AGK ~ % pip install -r requirements.txt
zsh: command not found: pip
I could send the complete terminal text since yesterday?
yeterday I got this:
(base) agk@iMac-von-AGK blender-manual % pip install -r requirements.txt
Collecting sphinx==6.0.1 (from -r requirements.txt (line 1))
Downloading sphinx-6.0.1-py3-none-any.whl (3.0 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.0/3.0 MB 2.1 MB/s eta 0:00:00
and more…
Can you try pip3 instead of pip?
[notice] A new release of pip is available: 23.0.1 → 23.1.2
[notice] To update, run: python3.11 -m pip install --upgrade pip
agk@iMac-von-AGK ~ % python3.11 -m pip install --upgrade pip
Requirement already satisfied: pip in /usr/local/lib/python3.11/site-packages (23.0.1)
Collecting pip
Using cached pip-23.1.2-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
Attempting uninstall: pip
Found existing installation: pip 23.0.1
Uninstalling pip-23.0.1:
Successfully uninstalled pip-23.0.1
Successfully installed pip-23.1.2
agk@iMac-von-AGK ~ % cd blender-manual
agk@iMac-von-AGK blender-manual % make
-e The ‘sphinx-build’ command was not found.
Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to
point to the full path of the ‘sphinx-build’ executable.
Alternatively you can add the directory with the executable to your PATH.
If you don’t have Sphinx installed, grab it from http://sphinx-doc.org)
make: *** [.SPHINXBUILD_EXISTS] Error 1
agk@iMac-von-AGK blender-manual % brew install sphinx-doc
==> Downloading .brew.sh/api/formula.jws.json
################################################################100.0%
==> Downloading .brew.sh/api/cask.jws.json
################################################################ 100.0%
Warning: sphinx-doc 7.0.1 is already installed and up-to-date.
To reinstall 7.0.1, run:
brew reinstall sphinx-doc
agk@iMac-von-AGK blender-manual % make
-e The ‘sphinx-build’ command was not found.
Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to
point to the full path of the ‘sphinx-build’ executable.
Alternatively you can add the directory with the executable to your PATH.
If you don’t have Sphinx installed, grab it from http://sphinx-doc.org)
make: *** [.SPHINXBUILD_EXISTS] Error 1
agk@iMac-von-AGK blender-manual %
There is both a macOS system python and a homebrew python, and it can be confusing to figure which one is being used where.
If you are installing sphinx through homebrew, this might help:
What circumstances. I’m sorry, I don’t understand. What should I do?
Run the command:
brew link sphinx-doc --force
Okay, it’s coming along.
I got the error message: Could not import extension sphinxcontrib.jquery
The Internet recommends for this: pip install sphinxcontrib-jquery
This still loaded and installed some files. I hope that was correct.
The make command then worked.
But, how to get the msnual in the right language?
The instructions for building with translations are here:
https://docs.blender.org/manual/en/dev/contribute/translations/contribute.html
The blender_manual.po lists text that is already translated in the current built-manual. What does this mean, should it be translated more than once?
Generally important, is there a complete translation of the manual? If yes, how many or better which ones?
Not sure I understand the question. The recommendation is to use an editor like poedit which shows the parts of the translation that are missing or outdated and need work.
There are some commands to check translation progress:
https://docs.blender.org/manual/en/dev/contribute/translations/contribute.html#keeping-track-of-fuzzy-strings
I don’t mean the state of the current translation. I’m asking for a fully translated manual (for any older Blender version). Has there ever been a manual completely translated? I guess not. Background is, the procedure to participate in the translation is very nerdy (for a translator). Many who would translate don’t even start or lose the desire, translating strings is boring.
The theme is translation of the manual, and the Blender help.
How is it going, did they understand me? I have some ideas, I would like to discuss them. If you don’t have time, please connect me with someone else competent.