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

[Martin Bless]

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?

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.

[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"?

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



[A]
http://docs.typo3.org/~mbless/git.typo3.org/Documentation/TYPO3/Reference/Typoscript.git.make/


Martin

-- 
Certified TYPO3 Integrator | TYPO3 Documentation Team Member

http://mbless.de