Skip to content

actions4gh/configure-wiki

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

46 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Configure for GitHub wiki

๐Ÿ“„ Transform ./My-page.md source links into ./My-page wiki links

<!-- README.md input -->
[Other page](./Other-page.md)
<!-- Home.md result -->
[Other page](./Other-page)

๐Ÿ”— Properly rewrites links to work when deployed to the wiki tab
๐Ÿ“› Also renames README.md to Home.md

๐Ÿ” See also actions4gh/configure-wiki/reverse which is the inverse of this action. It converts wiki-style links to source-style.

Usage

GitHub Actions GitHub

๐Ÿš€ Here's what you're after:

# .github/workflows/deploy-wiki.yml
name: deploy-wiki
on:
  push:
    branches: "main"
    paths: wiki/**
jobs:
  deploy-wiki:
    permissions:
      contents: write
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions4gh/configure-wiki@v1
      - uses: actions4gh/deploy-wiki@v1

๐Ÿ‘€ Check out actions4gh/deploy-wiki!

โš ๏ธ Currently this Action only processes Markdown links in Markdown files. In the future AsciiDoc and other formats may be supported.

Inputs

  • path: Where the wiki files are. This must be a folder. Defaults to wiki/. All files one level deep (not recursively) in this folder will be processed.

Outputs

  • base-url: The base URL of the wiki. Usually this is something like https://github.com/octocat/project/wiki/.