forked from espressif/esp-protocols
51 lines
1.6 KiB
YAML
51 lines
1.6 KiB
YAML
name: Docs and Publish
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- master
|
|
|
|
jobs:
|
|
docs_build:
|
|
name: Docs-Build-And-Upload
|
|
runs-on: ubuntu-latest
|
|
|
|
steps:
|
|
- name: Checkout esp-protocols
|
|
uses: actions/checkout@master
|
|
with:
|
|
persist-credentials: false
|
|
fetch-depth: 0
|
|
|
|
- name: Generate docs
|
|
run: |
|
|
sudo apt-get update
|
|
sudo apt-get -y install doxygen clang python3-pip
|
|
python -m pip install breathe recommonmark esp-docs==0.2.1
|
|
cd $GITHUB_WORKSPACE/components/esp_modem/docs
|
|
./generate_docs
|
|
mkdir -p $GITHUB_WORKSPACE/docs/esp_modem
|
|
cp -r html/. $GITHUB_WORKSPACE/docs/esp_modem
|
|
cd $GITHUB_WORKSPACE/components/esp_websocket_client/docs
|
|
./generate_docs
|
|
mkdir -p $GITHUB_WORKSPACE/docs/esp_websocket_client
|
|
cp -r html/. $GITHUB_WORKSPACE/docs/esp_websocket_client
|
|
cd $GITHUB_WORKSPACE/docs
|
|
touch .nojekyll
|
|
echo '<a href="esp_modem/index.html">esp-modem</a>' > index.html
|
|
echo '<a href="esp_websocket_client/index.html">esp-websocket-client</a>' >> index.html
|
|
|
|
|
|
- name: Upload components to component service
|
|
uses: espressif/github-actions/upload_components@master
|
|
with:
|
|
directories: "components/esp_modem;components/esp_websocket_client"
|
|
namespace: "espressif"
|
|
api_token: ${{ secrets.IDF_COMPONENT_API_TOKEN }}
|
|
|
|
- name: Deploy generated docs
|
|
uses: JamesIves/github-pages-deploy-action@4.1.5
|
|
with:
|
|
branch: gh-pages
|
|
folder: docs
|