Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
jcbhmr authored Nov 4, 2023
1 parent 156b136 commit 3d7bd22
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 3 deletions.
26 changes: 23 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,30 @@
# Configure for GitHub wiki (reverse)
# Configure for GitHub wiki

📄 Transform `./My-page` wiki links into `./My-page.md` source links
📄 Transform `./My-page.md` source links into `./My-page` wiki links

<table align=center><td>

```md
<!-- README.md input -->

[Other page](./Other-page.md)
```

<td>

```md
<!-- Home.md result -->

[Other page](./Other-page)
```

</table>

🔁 See also [actions4gh/configure-wiki/reverse] which is the inverse of this action. It converts wiki-style links to source-style.
🔗 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

Expand Down Expand Up @@ -47,4 +53,18 @@ jobs:
👀 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/`.

[actions4gh/deploy-wiki]: https://github.com/actions4gh/deploy-wiki
9 changes: 9 additions & 0 deletions action.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,17 @@ branding:

inputs:
path:
description: >
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.
default: wiki

outputs:
base-url:
description: >
The base URL of the wiki. Usually this is something like
https://github.com/octocat/project/wiki/.
runs:
using: node20
main: _main.mjs #=> main.ts

0 comments on commit 3d7bd22

Please sign in to comment.