xconfluencebuilder/samples/default/README.md
Rodweil, Theodor d649185ef6
feat: init
2023-08-07 01:26:15 +02:00

27 lines
782 B
Markdown

# Default Sample
This is a sample/reference implementation of the `xconfluencebuilder`. It
provides a Sphinx build with 2 ancestrally related pages, where the child page
contains an attachment.
Output is directed to the `build/` directory, which will contain the regular
``sphinxcontrib.confluencebuilder`` artifacts in addition to the publishing
manifest and referenced assets.
# Instructions
To run this reference implementation, you are required to have
[pipenv](https://pipenv.pypa.io/en/latest/) installed on your system.
Install the virtual environment by executing the following command from within
this directory:
```
$ python3 -m pipenv install
```
Afterwards, you can build all assets by issuing the following command
```
$ python3 -m pipenv run sphinx-build
```