From a6496a8a3bafae1b4674a0a274d15a47c978c087 Mon Sep 17 00:00:00 2001 From: Priyadi Iman Nurcahyo <1102197+priyadi@users.noreply.github.com> Date: Sat, 11 May 2024 10:57:16 +0700 Subject: [PATCH] initial commit --- .github/workflows/image.yml | 59 +++++++++++++++++++++++++++++++++++++ Dockerfile | 12 ++++++++ LICENSE | 18 +++++++++++ README.md | 3 ++ requirements.txt | 5 ++++ 5 files changed, 97 insertions(+) create mode 100644 .github/workflows/image.yml create mode 100644 Dockerfile create mode 100644 LICENSE create mode 100644 README.md create mode 100644 requirements.txt diff --git a/.github/workflows/image.yml b/.github/workflows/image.yml new file mode 100644 index 0000000..c12c0a0 --- /dev/null +++ b/.github/workflows/image.yml @@ -0,0 +1,59 @@ +# +name: Generate Images + +on: + push: + tags: + - '*' + workflow_dispatch: {} + +# Defines two custom environment variables for the workflow. These are used for the Container registry domain, and a name for the Docker image that this workflow builds. +env: + REGISTRY: ghcr.io + ORGANIZATION: rekalogika + IMAGENAME: sphinx + +# There is a single job in this workflow. It's configured to run on the latest available version of Ubuntu. +jobs: + build-and-push-image: + runs-on: ubuntu-latest + + # Sets the permissions granted to the `GITHUB_TOKEN` for the actions in this job. + permissions: + contents: read + packages: write + # + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + # Uses the `docker/login-action` action to log in to the Container registry registry using the account and password that will publish the packages. Once published, the packages are scoped to the account defined here. + - name: Log in to the Container registry + uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1 + with: + registry: ${{ env.REGISTRY }} + username: ${{ github.actor }} + password: ${{ secrets.GITHUB_TOKEN }} + + # This step uses [docker/metadata-action](https://github.com/docker/metadata-action#about) to extract tags and labels that will be applied to the specified image. The `id` "meta" allows the output of this step to be referenced in a subsequent step. The `images` value provides the base name for the tags and labels. + - name: Extract metadata (tags, labels) for Docker + id: meta + uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7 + with: + images: ${{ env.REGISTRY }}/${{ env.ORGANIZATION }}/${{ env.IMAGENAME }} + tags: | + type=ref,event=branch + type=ref,event=pr + type=semver,pattern={{version}} + type=semver,pattern={{major}}.{{minor}} + + # This step uses the `docker/build-push-action` action to build the image, based on your repository's `Dockerfile`. If the build succeeds, it pushes the image to GitHub Packages. + # It uses the `context` parameter to define the build's context as the set of files located in the specified path. For more information, see "[Usage](https://github.com/docker/build-push-action#usage)" in the README of the `docker/build-push-action` repository. + # It uses the `tags` and `labels` parameters to tag and label the image with the output from the "meta" step. + - name: Build and push Docker image + uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4 + with: + context: . + push: true + tags: ${{ steps.meta.outputs.tags }} + labels: ${{ steps.meta.outputs.labels }} diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..07ca958 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,12 @@ +FROM docker.io/sphinxdoc/sphinx:7.3.7 + +WORKDIR /docs + +ADD requirements.txt / +RUN set -eux ; \ + pip3 install -r /requirements.txt ; \ + apt-get update && apt-get install -y curl ; \ + curl -L https://raw.githubusercontent.com/riboseinc/plantuml-install/master/ubuntu.sh | bash ; \ + apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false ; \ + rm -rf /var/lib/apt/lists/*; \ + true \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..c34d9bc --- /dev/null +++ b/LICENSE @@ -0,0 +1,18 @@ +Copyright (c) 2024-present Priyadi Iman Nurcahyo + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..b802597 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# Sphinx Image + +Adds PlantUML support to official Sphinx image. \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..458bb60 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,5 @@ +sphinxcontrib-plantuml +furo +sphinx-rtd-theme +sphinx-tabs +guzzle_sphinx_theme