Sphinx TYPO3 theme for docs.typo3.org¶
Sphinx TYPO3 theme contains all files required to build a Sphinx extension that provides the theme.
Maintainer: Martin Bless <firstname.lastname@example.org>
Provided by the TYPO3 documentation team.
Free software: MIT license
Authors: See AUTHORS.rst
Documentation: See docs/ folder and https://typo3-documentation.github.io/sphinx_typo3_theme/
Make sure to specify all three numbers as in ‘v99.88.77’.
There also is a demo manual which serves as a “stress test” for the theme and shows what markup is possible and how it gets rendered.
We are using Ubuntu (22.04) for development with Python3 installed. Further we are using GNU make for convenience. Next we are using the Node Version Manager (NVM) to install and activate Node version v12:
❯ nvm install 12
❯ nvm ls # list installed version
❯ nvm use v12 # activate
❯ npm install -g yarn
❯ npm install -g grunt
Clone the repository:
❯ git clone https://github.com/TYPO3-Documentation/sphinx_typo3_theme/
❯ cd sphinx_typo3_theme # go there
❯ make # see what options you have
❯ cat Makefile # read for understanding
❯ cat Gruntfile.js # read for understanding
Use Node version v12, show Python version:
❯ nvm use v12
Now using node v12.22.12 (npm v6.14.16)
❯ python --version
Install the Python modules, install the Node modules and build everything:
make setup buildall
Repeat as you like:
Look at folder ./dist to find the build results:
❯ ls ./dist
You may study as well the GitHub workflows of this repository.
This theme has not been used or tested with Sphinx versions that are newer than Sphinx-4.5.0.