Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/decathlon/wiki-page-creator-action
Create a GitHub wiki page based on the provided markdown file
https://github.com/decathlon/wiki-page-creator-action
github-actions wiki
Last synced: 3 days ago
JSON representation
Create a GitHub wiki page based on the provided markdown file
- Host: GitHub
- URL: https://github.com/decathlon/wiki-page-creator-action
- Owner: Decathlon
- License: apache-2.0
- Created: 2019-06-05T20:52:04.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-03-28T13:54:29.000Z (over 2 years ago)
- Last Synced: 2024-11-02T16:35:02.874Z (12 days ago)
- Topics: github-actions, wiki
- Language: Shell
- Size: 28.3 KB
- Stars: 94
- Watchers: 3
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Wiki Page Creator GitHub Action
This repository provides a GitHub action to publish Wiki pages with a provided markdown into the Wiki section of your GitHub repository.
**Table of Contents**
- [Common usage](#common-usage)
- [Use GitHub action](#use-github-action)
- [Settings for v2.0.0+ release](#settings-for-v200-release)
- [Environment Variables options](#environment-variables-options)
- [Full Example (with additional actions to generate content)](#full-example-with-additional-actions-to-generate-content)
- [Using v2.0.0+](#using-v200)
- [Credits](#credits)
## Common usage
The action requires some content _markdown/wiki pages_ that must be generated on a previous step, and located into a specific folder.
This action scans the folder, adds its files, and finally publishes them to the wiki.
## Use GitHub action
__*Please note that this action requires your repo to already own at least one page in the wiki section: https://github.com/:yourOrganization/:yourRepository/wiki*__
### Settings for v2.0.0+ release
```YAML
- name: Upload Release Notes to Wiki
uses: docker://decathlon/wiki-page-creator-action:latest
env:
GH_PAT: ${{ secrets.GH_PAT }}
ACTION_MAIL: [email protected]
ACTION_NAME: yourusername
OWNER: yourGitHubOrganisation
REPO_NAME: yourGitHubRepository
```
### Environment Variables options
To be able to push the new Wiki Page, the action requires some environment variables/secrets:
* **GH_PAT**: (required) GitHub Private Access Token used for the clone/push operations. The token is used for security reasons, instead of the username/password, and because is the only way to access to repositories for organizations using SSO. You can [click here](https://github.com/settings/tokens/new?scopes=repo&description=wiki%20page%20creator%20token) to generate this token.
Copy the secret key of the Token and the secret in Settings -> Secrets -> Add new with name=GH_PAT and value=your_secret_key
* **ACTION_MAIL**: (required) email used to push new wiki pages into the target repository
* **ACTION_NAME**: (required) username to use in the push command
* **OWNER**: (required) repository owner name.
* **REPO_NAME**: (required) repository name where you want to upload the wiki page to.
* **MD_FOLDER**: (optional - default is the current folder) folder to scan for markdown files
* **SKIP_MD**: (optional - all files will be processed) comma separated list of files to skip during the analysis (files you don't want to publish)
* **WIKI_PUSH_MESSAGE**: (optional - sample message will use instead) Custom push message for your wiki pages.
* **TRANSLATE_UNDERSCORE_TO_SPACE** (optional) Will translate the underscore in Markdown's names to spaces in your Wiki (disabled by default)
## Full Example (with additional actions to generate content)
The following one is the workflow we are using to push the release notes to our project wikis.
In this example the workflow is started `on milestone`; the first action is filtering on the `closed` action of the milestone (if milestone is created, renamed, ... the other steps are skipped).
The `create-release-notes-action` creates the markdown file (check [here](https://github.com/Decathlon/release-notes-generator-action) if your need more information).
The output file is stored into the `temp_release_notes`.
The `wiki-page-creator-action` takes all the markdown files from the `temp_release_notes` folder (skipping a README.md file if found) and uploads them to the provided wiki repo.
### Using v2.0.0+
```YAML
on:
milestone:
types: [closed]
name: Milestone Closure
jobs:
release-notes:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@master
- name: Create Release Notes
uses: docker://decathlon/release-notes-generator-action:2.0.0
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
OUTPUT_FOLDER: temp_release_notes
USE_MILESTONE_TITLE: "true"
- name: Upload Release Notes to Wiki
uses: docker://decathlon/wiki-page-creator-action:latest
env:
ACTION_MAIL: [email protected]
ACTION_NAME: myPushingUser
GH_PAT: ${{ secrets.GH_PAT }}
MD_FOLDER: temp_release_notes
OWNER: yourGitHubOrganisation
REPO_NAME: yourGitHubRepository
SKIP_MD: README.md
```
# Credits
The code of this actions began on [mmornati](https://github.com/mmornati) GitHub workspace.