This is the OXID eShop developer documentation.
The generated documentation can be found here: https://docs.oxid-esales.com/developer/en/6.5/
If you want to contribute, please read https://docs.oxid-esales.com/developer/en/6.5/index.html#help-improving-this-documentation. Generate the documentation locally in order to test your changes as described in the following section.
Section describes how to generate documentation locally.
First of all you'll need to install sphinx
Install the PHP highlighting extensions
Install the plantuml extension. Either configure the path to the file plantuml.jar in the file config.py or put a wrapper script in your path like described in the link above.
- Clone documentation repository:
git clone https://github.com/OXID-eSales/developer_documentation.git
- To generate documentation run:
cd developer_documentation sphinx-build ./ ./build
Open build/index.html file with your browser.
To generate diagrams using plantUml, use this command:
java -jar /opt/plantuml.jar -svg -o ./ **.puml
/opt/plantuml.jar - path to your plantUml file.
PlantUml will generate .svg files, which can be used in documentation.
By being in the root of the project (where Makefile is), install the documentation and required containers by using following commands:
git clone https://github.com/OXID-eSales/developer_documentation docs
make addsphinxservice docpath='./docs'
docker-compose up --build -d sphinx
To run documentation regeneration, use:
make generate-docs
Generated documentation will be available in docs/build folder