Feature/map fragment #7604
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: Documentation | |
on: | |
workflow_dispatch: | |
schedule: | |
- cron: 0 0 * * * | |
push: | |
branches: | |
- master | |
pull_request: | |
branches: | |
- master | |
jobs: | |
generate: | |
name: Generate Documentation | |
runs-on: ubuntu-22.04 | |
steps: | |
- uses: actions/checkout@v2-beta | |
- name: Setup Docker Buildx | |
uses: docker/setup-buildx-action@v2 | |
- name: run protoc-gen-doc | |
run: docker run --rm -v $(pwd)/simulation/simulation_interface/proto/:/protos -v $(pwd)/docs/proto_doc:/out pseudomuto/protoc-gen-doc --doc_opt=markdown,protobuf.md | |
- name: Set up Python | |
uses: actions/setup-python@v4 | |
with: | |
python-version: "3.10" | |
- uses: abatilo/actions-poetry@v2 | |
with: | |
poetry-version: "1.5.1" | |
- name: install | |
run: poetry install --no-interaction | |
- name: Install doxygen/depends of doxybook | |
run: sudo apt install -y doxygen wget | |
- name: Wget package | |
run: | | |
wget https://github.com/matusnovak/doxybook2/releases/download/v1.2.3/doxybook2-linux-amd64-v1.2.3.zip | |
mkdir -p ~/doxybook2 | |
cp -rf . ~/doxybook2 | |
cd ~/doxybook2 | |
unzip doxybook2-linux-amd64-v1.2.3.zip | |
# generating traffic_simulator package documentation | |
- name: Generate doxygen for traffic_simulator package | |
run: | | |
cd docs/package/traffic_simulator | |
doxygen Doxyfile | |
- name: Generate markdown for traffic_simulator package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/traffic_simulator | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
# generating simple_sensor_simulator package documentation | |
- name: Generate doxygen for simple_sensor_simulator package | |
run: | | |
cd docs/package/simple_sensor_simulator | |
doxygen Doxyfile | |
- name: Generate markdown for simple_sensor_simulator package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/simple_sensor_simulator | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
# generating simulation_interface package documentation | |
- name: Generate doxygen for simulation_interface package | |
run: | | |
cd docs/package/simulation_interface | |
doxygen Doxyfile | |
- name: Generate markdown for simulation_interface package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/simulation_interface | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
# generating openscenario_interpreter package documentation | |
- name: Generate doxygen for openscenario_interpreter package | |
run: | | |
cd docs/package/openscenario_interpreter | |
doxygen Doxyfile | |
- name: Generate markdown for openscenario_interpreter package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/openscenario_interpreter | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
# generating openscenario_visualization package documentation | |
- name: Generate doxygen for openscenario_visualization package | |
run: | | |
cd docs/package/openscenario_visualization | |
doxygen Doxyfile | |
- name: Generate markdown for openscenario_visualization package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/openscenario_visualization | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
# generating geometry package documentation | |
- name: Generate doxygen for geometry package | |
run: | | |
cd docs/package/geometry | |
doxygen Doxyfile | |
- name: Generate markdown for geometry package | |
run: | | |
export PATH="$PATH:~/doxybook2/bin" | |
cd docs/package/geometry | |
mkdir -p ./markdown/Classes | |
doxybook2 --input ./build/ --output ./markdown -c config.json | |
- name: Generate documentation | |
run: poetry run mkdocs build | |
- name: Upload Artifact | |
uses: actions/upload-artifact@v2 | |
with: | |
name: site | |
path: site | |
retention-days: 1 | |
- name: Publish Documentation | |
if: ${{ github.event_name == 'push' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'}} | |
uses: peaceiris/actions-gh-pages@v3 | |
with: | |
personal_token: ${{ secrets.BLOOM_GITHUB_TOKEN }} | |
publish_dir: site | |
keep_files: false | |
external_repository: tier4/scenario_simulator_v2-docs |