This action builds on repository specific product page as static github page.
To use this action, simply include it as a step in your workflow file. No inputs are required.
name: My Product Page Workflow
on:
schedule:
- cron: '0 0 * * *'
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Deploy Product Github Page
uses: OpenCatalogi/productpage-action@latestIn the above example an page is created or updated every night at 0:00, we advise this route becouse you will autmaticly suplied with fixes and new features. You can however also choose other options to trigger a page build
To trigger a page build whenever you commit something to the main branche
on:
push:
branches:
- mainTo gain a bit more control and only trigger a page build manually usw
on:
workflow_dispatch:Warning If you do not supply the action with an access token or an SSH key, you must access your repositories settings and provide
Read and Write Permissionsto the providedGITHUB_TOKEN, otherwise you'll potentially run into permission issues. Alternatively you can set the following in your workflow file to grant the action the permissions it needs.
permissions:
contents: writeNote When you first run the workflow you need to
manuallyactivate github pages on your repository! Head over to setting -> pages. Selectdeploy form a branchas a source andgh-pagesas your branche (unles you configured the page to be build in a differend branche)Afther pressing save head over tot the actions and take a look at the
pages build and deploymentactionWhen it is done it will also tell you under wich link you can find your page
| Input Name | Description | Default Value |
|---|---|---|
github_api_base_url |
The base URL to get the README.md from (Optional) | https://api.github.com/repos/OpenCatalogi/.github/contents/ |
favicon_image |
A base64 encoded SVG file or URL to the image used as favicon (Optional) | https://dev.opencatalogi.nl/static/logo_OpenCatalogi-8b1b0a001c3f37dae4d3f69b5964ec72.png |
nl_design_theme_classname |
The class name of the desired NL design theme (Optional) | open-webconcept-theme |
page_title |
The title of the page (Optional) | Product page |
github_docs_directory_paths |
The menu item shown and the locations that they are collected from (Optional) | [{"name": "Handleidingen", "location": "/docs/handleidingen"},{"name": "Roadmap", "location": "/docs/roadmap"}] |
navbar_logo |
A base64 encoded SVG file or URL to the logo used in the main menu (Optional) | https://openwebconcept.nl/wp-content/themes/openwebconcept/assets/src/images/logo@2x.png |
navbar_content |
A link to the json file that manages the navbar content (Optional) | https://raw.githubusercontent.com/ConductionNL/product-website-template/main/pwa/src/templates/templateParts/header/HeaderContent.json |
github_pages_branch |
The branch on which the GitHub page will be built (Optional) | gh-pages |
read_the_docs_url |
The documentation URL (set to empty to omit documentation from your menu) (Optional) | https://commongateway.readthedocs.io/en/latest/ |
slack_url |
The Slack URL (set to empty to omit Slack from your menu) (Optional) | https://join.slack.com/t/samenorganiseren/shared_invite/zt-22wtrcb1y-RMdSp6C1LMhUaCZQlL9trQ |
jumbotron_title |
The title of the jumbotron (Optional) | github.event.repository.name |
jumbotron_subtitle |
The (short) subtitle used in the jumbotron (Optional) | Product page |
jumbotron_description |
The (long) description included in the jumbotron (Optional) | github.event.repository.description |
jumbotron_image |
A base64 encoded SVG file or URL to the logo used in the jumbotron (Optional) | '' |
footer_show_logo |
Whether to show to logo in the footer or not (Optional) | true |
footer_logo_href |
The URL that the footer image will link to (set to blank to not link) (Optional) | https://openwebconcept.nl/ |
footer_content |
A link to the json file that manages the footer content (Optional) | https://raw.githubusercontent.com/ConductionNL/product-website-template/main/pwa/src/templates/templateParts/header/HeaderContent.json |
footer_content_header |
The heading size used in the footer ("heading-1" to "heading-5" ) (Optional) | heading-3 |
footer_show_creator |
Shows the "<> with love from Conduction" link' (Optional) | true |
github_repository_name |
The name of the GitHub repository (Optional) | github.event.repository.name |
github_repository_name_as_prefix |
Whether to use the GitHub repository name as a prefix (Optional) | true |
github_repository_url |
The url to the GitHub repository (Optional) | github.event.repository.url |
pull_from_branche |
The branche on witch to base the build e.g. main or development | development |
gitname |
Git name configuration for bump commit (Optional) | Open Catalogi bot |
gitmail |
Git mail configuration for bump commit (Optional) | bot@opencatalogi.nl |
| Output Name | Description |
|---|---|
version |
New version of the softwareVersion field in publiccode.yml |
releaseDate |
New release date of the releaseDate field in publiccode.yml |
Besides making your product readable for humans its als a good idea to make it machisne readable, this helps your project to be indexed by the likes of opencatalogi.nl. Luckily this is very simple, just ad the publiccode action to your workflow
name: My PublicCode Workflow
on:
push:
branches:
- main
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Deploy Product Github Page
uses: OpenCatalogi/productpage-action@latest
- name: Update publiccode.yaml
uses: OpenCatalogi/publiccode-action@latestRead more about the publiccode action
As is the case with most software this action is based on the work of others, and uses there code. We would like to give a special shout out to the following parties and thier code
This software is maintained by Conduction b.v.
© 2023 Conduction B.V.
Licensed under the EUPL. The version control system provides attribution for specific lines of code.
This GitHub Action is published in the GitHub Marketplace. As such, you can find the Terms of Service here. Also, here you can find the GitHub Marketplace Developer Agreement.