Update per latest gir/gir-files #4276
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: docs | |
| on: | |
| push: | |
| branches: [main] | |
| paths: | |
| - ".github/workflows/docs.yml" | |
| - "gdk4/**" | |
| - "gdk4-macos/**" | |
| - "gdk4-wayland/**" | |
| - "gdk4-win32/**" | |
| - "gdk4-x11/**" | |
| - "gsk4/**" | |
| - "gtk4/**" | |
| - "gtk4-macros/**" | |
| - "**/README.md" | |
| pull_request: | |
| paths: | |
| - ".github/workflows/docs.yml" | |
| - "gdk4/**" | |
| - "gdk4-macos/**" | |
| - "gdk4-wayland/**" | |
| - "gdk4-win32/**" | |
| - "gdk4-x11/**" | |
| - "gsk4/**" | |
| - "gtk4/**" | |
| - "gtk4-macros/**" | |
| - "**/README.md" | |
| workflow_dispatch: | |
| release: | |
| types: [published] | |
| jobs: | |
| build-deploy: | |
| runs-on: ubuntu-latest | |
| name: build | |
| container: | |
| image: ghcr.io/gtk-rs/gtk4-rs/gtk4:latest | |
| env: | |
| RELEASES: | | |
| 0.9=0.9 | |
| 0.8=0.8 | |
| 0.7=0.7 | |
| 0.6=0.6 | |
| 0.5=0.5 | |
| 0.4=0.4 | |
| 0.3=0.3 | |
| RUSTFLAGS: --cfg docsrs | |
| steps: | |
| - uses: actions/checkout@v4 | |
| with: | |
| submodules: "recursive" | |
| set-safe-directory: true | |
| - uses: actions-rs/toolchain@v1 | |
| with: | |
| profile: minimal | |
| toolchain: nightly | |
| override: true | |
| components: rustfmt | |
| - run: git config --global --add safe.directory /__w/gtk4-rs/gtk4-rs | |
| - run: git submodule update --checkout | |
| - run: cargo install rustdoc-stripper | |
| - run: git clone https://gitlab.gnome.org/World/Rust/gir-rustdoc/ # checkout action doesn't support random urls | |
| - run: python3 ./generator.py --embed-docs --yes ./ | |
| - run: echo "RELEASE=$(echo '${{ github.event.release.tag_name }}' | grep -Po '(\d+)\.(\d+)')" >> ${GITHUB_ENV} | |
| - run: echo "DEST=$(if [ "$GITHUB_EVENT_NAME" == "release" ]; then echo 'stable/${{ env.RELEASE }}'; else echo 'git'; fi)" >> ${GITHUB_ENV} | |
| - run: echo "RUSTDOCFLAGS=$(eval python3 ./gir-rustdoc/gir-rustdoc.py --pages-url 'https://gtk-rs.org/gtk4-rs/' --default-branch 'main' pre-docs | xargs)" >> ${GITHUB_ENV} | |
| env: | |
| RUSTDOCFLAGS: > | |
| --extern-html-root-url=wayland_client=https://smithay.github.io/wayland-rs/ | |
| --extern-html-root-url=x11=https://docs.rs/x11/latest/ | |
| --extern-html-root-url=khronos_egl=https://docs.rs/khronos-egl/latest/ | |
| --extern-html-root-url=xkb=https://docs.rs/xkb/latest/ | |
| --extern-html-root-url=windows=https://microsoft.github.io/windows-docs-rs/doc/ | |
| --extern-html-root-url=gl=https://docs.rs/gl/latest/ | |
| --cfg docsrs | |
| -Zunstable-options --generate-link-to-definition | |
| - uses: actions-rs/cargo@v1 | |
| with: | |
| command: doc | |
| args: > | |
| -p gdk4 -p gdk4-sys | |
| -p gdk4-wayland -p gdk4-wayland-sys | |
| -p gdk4-win32 -p gdk4-win32-sys | |
| -p gdk4-x11 -p gdk4-x11-sys | |
| -p gsk4 -p gsk4-sys | |
| -p gtk4 -p gtk4-sys | |
| -p gdk4-macos -p gdk4-macos-sys | |
| -p gtk4-macros | |
| --all-features | |
| --no-deps | |
| - name: Fix broken URLs | |
| run: | | |
| sed -i 's|section-list-widget.html|https://docs.gtk.org/gtk4/section-list-widget.html|g' target/doc/gtk4/struct.ColumnView.html | |
| sed -i 's|section-list-widget.html|https://docs.gtk.org/gtk4/section-list-widget.html|g' target/doc/gtk4/struct.ListBox.html | |
| sed -i 's|section-list-widget.html|https://docs.gtk.org/gtk4/section-list-widget.html|g' target/doc/gtk4/struct.ListView.html | |
| sed -i 's|section-list-widget.html|https://docs.gtk.org/gtk4/section-list-widget.html|g' target/doc/gtk4/struct.GridView.html | |
| sed -i 's|input-handling.html|https://docs.gtk.org/gtk4/input-handling.html|g' target/doc/gtk4/struct.EventController.html | |
| sed -i 's|coordinates.html|https://docs.gtk.org/gtk4/coordinates.html|g' target/doc/gdk4/struct.Event.html | |
| sed -i 's|coordinates.html|https://docs.gtk.org/gtk4/coordinates.html|g' target/doc/gtk4/struct.Widget.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextBuffer.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextIter.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextMark.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextTag.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextTagTable.html | |
| sed -i 's|section-text-widget.html|https://docs.gtk.org/gtk4/section-text-widget.html|g' target/doc/gtk4/struct.TextView.html | |
| sed -i 's|section-tree-widget.html|https://docs.gtk.org/gtk4/section-tree-widget.html|g' target/doc/gtk4/struct.TreeView.html | |
| - name: GTK Docs Images | |
| if: ${{ (github.event_name == 'push' && github.ref == 'refs/heads/main') || github.event_name == 'release' }} | |
| run: | | |
| git clone --depth=1 https://gitlab.gnome.org/GNOME/gtk --no-checkout ./gtk-src | |
| cd ./gtk-src | |
| git sparse-checkout init --cone | |
| git sparse-checkout set docs/reference/gtk/images | |
| git checkout main | |
| mv ./docs/reference/gtk/images/*.png ../target/doc/gtk4 | |
| - name: Grab gtk-rs LOGO | |
| if: ${{ (github.event_name == 'push' && github.ref == 'refs/heads/main') || github.event_name == 'release' }} | |
| run: | | |
| wget https://raw.githubusercontent.com/gtk-rs/gtk-rs.github.io/main/logo/gtk-rs-16.png -O ./target/doc/favicon-16x16.png | |
| wget https://raw.githubusercontent.com/gtk-rs/gtk-rs.github.io/main/logo/gtk-rs-32.png -O ./target/doc/favicon-32x32.png | |
| wget https://raw.githubusercontent.com/gtk-rs/gtk-rs.github.io/main/logo/gtk-rs-256.png -O ./target/doc/rust-logo.png | |
| wget https://raw.githubusercontent.com/gtk-rs/gtk-rs.github.io/main/logo/gtk-rs.svg -O ./target/doc/rust-logo.svg | |
| wget https://raw.githubusercontent.com/gtk-rs/gtk-rs.github.io/main/logo/gtk-rs.svg -O ./target/doc/favicon.svg | |
| - name: deploy | |
| uses: peaceiris/actions-gh-pages@v4 | |
| if: ${{ (github.event_name == 'push' && github.ref == 'refs/heads/main') || github.event_name == 'release' }} | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: ./target/doc/ | |
| keep_files: false | |
| destination_dir: ${{ env.DEST }}/docs | |
| - run: python3 ./gir-rustdoc/gir-rustdoc.py --project-title 'GTK 4 Rust bindings' html-index --early-section 'Book' '<ul><li><a href="stable/latest/book">Latest stable</a></li></ul>' | |
| - name: deploy index page | |
| uses: peaceiris/actions-gh-pages@v4 | |
| if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }} | |
| with: | |
| github_token: ${{ secrets.GITHUB_TOKEN }} | |
| publish_dir: ./public/ | |
| keep_files: true | |
| #force_orphan: true | |
| destination_dir: ./ |