[TYPO3-doc] Extending Sphinx for TYPO3: cannot compile as JSON

[Philipp Gampe]

Hi Martin Bless,

Martin Bless wrote:

> Hi Philipp,
> 
>>In my attempts, I could never generate the TYPO3 theme, it always loaded
>>the default theme, even if I regenerated the the sphinx in the update
>>script.
> 
> Q1:
>    Do you use the ./_make/Makefile in the ./_make folder?

yes

> If so:
> 
> Q2:
>    Do get these files (see [A] for examples) as a result:
> 
>      ./_make/_not_versioned/warnings.txt
> [10] ./_make/_not_versioned/10_conf_py.yml
> [20] ./_make/_not_versioned/20_GlobalSettings.yml
> [30] ./_make/_not_versioned/30_Settings.yml
> 
>      ./_make/_not_versioned/10+20_conf_py.yml
>      ./_make/_not_versioned/10+20+30_conf_py.yml
>    
> The Yaml files here are not read but only written by our Sphinx.
> Consider them as logfiles. Having them in Yaml format makes it
> easy of course to reuse the Yaml code.

I only have an empty warnings file (for TcaReference).

> [10] 10_conf_py.yml
> displays the builtin settings and those given in conf.py.
> 
> [20] 20_GlobalSettings.yml
> displays our TYPO3 GlobalSettings.yml
> 
> [30] 30_Settings.yml
> displays the project specific Settings.yml
> 
> "10+20+30_conf_py.yml"
> then tells you the effective settings which have been made by
> overriding [10] with [20] and afterwards overriding it by [30].
> 
> 
> Q3:
>    If you have [10+20+30]: What does it say for: "html_theme"?

Nope, see above

> Should be:
> 
> conf.py:
>   html_theme: t3org
> 
> 
> 
> If the Yaml files are missing: Did you install Yaml support for
> your Python? See: http://wiki.typo3.org/Rendering_reST_on_Linux

Might be ... I get this:

> # easy_install pyyaml
> Searching for pyyaml
> Reading http://pypi.python.org/simple/pyyaml/
> Reading http://pyyaml.org/wiki/PyYAML
> Best match: PyYAML 3.10
> Downloading http://pyyaml.org/download/pyyaml/PyYAML-3.10.zip
> Processing PyYAML-3.10.zip
> Writing /tmp/easy_install-k1yFdn/PyYAML-3.10/setup.cfg
> Running PyYAML-3.10/setup.py -q bdist_egg --dist-dir /tmp/easy_install-
k1yFdn/PyYAML-3.10/egg-dist-tmp-Qj23Sq
> build/temp.linux-x86_64-2.7/check_libyaml.c:2:18: schwerwiegender Fehler: 
yaml.h: Datei oder Verzeichnis nicht gefunden
> Kompilierung beendet.
> 
> libyaml is not found or a compiler error: forcing --without-libyaml
> (if libyaml is installed correctly, you may need to
>  specify the option --include-dirs or uncomment and
>  modify the parameter include_dirs in setup.cfg)
> zip_safe flag not set; analyzing archive contents...
> Adding PyYAML 3.10 to easy-install.pth file
> 
> Installed /usr/lib/python2.7/site-packages/PyYAML-3.10-py2.7-linux-
x86_64.egg
> Processing dependencies for pyyaml
> Finished processing dependencies for pyyaml


Now it works. Thanks for the hint.


Btw, it looks like the global python installation still has precedence over 
the version build in EXT:sphinx, because this is build with


> Update script for sphinx
> 
> Sphinx 1.1.3 has been downloaded.
> Sphinx 1.1.3 has been unpacked.
> Sphinx 1.1.3 has been successfully installed.
> TYPO3 ReStructuredText Tools (845f6708ba3771ad316ee1c0b38f62459096b1d8) 
have been downloaded.
> TYPO3 ReStructuredText Tools have been unpacked.
> TYPO3 RestructuredText Tools have been successfully installed.
> PyYAML 3.10 has been downloaded.
> PyYAML has been unpacked.
> PyYAML has been successfully installed.
> Following versions of Sphinx may be installed locally:


Thus PyYAML should be installed.

Best regards
-- 
Philipp Gampe – PGP-Key 0AD96065 – TYPO3 UG Bonn/Köln
Documentation – Active contributor TYPO3 CMS
TYPO3 .... inspiring people to share!