Skip to content

Commit 492ee7f

Browse files
committed
Set version to 0.6.0 for main yml. Breaking change: REPOSITORY env variable was removed, replaced by TITLE.
1 parent 9c1f67e commit 492ee7f

File tree

2 files changed

+19
-2
lines changed

2 files changed

+19
-2
lines changed

README.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,16 +53,20 @@ In order to make the "last edit date" plugin work you need to clone the full his
5353
with:
5454
src: doc
5555
dst: generated
56+
title: Markdown Docs
5657
language: en
5758
icon: library
5859
primary-color: indigo
5960
secondary-color: indigo
61+
hide-repository: false
6062
```
6163
##### Additional parameters info
64+
* `title` is an optional parameter (defaults to the name of the repository, such as `ldeluigi/markdown-docs` or `Documentation` if no repo is detected) that sets the title displayed at the top of the documentation website.
6265
* `language` is an optional paramater (defaults to `en`) that allows to change [language features](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#site-language) and [search features](https://squidfunk.github.io/mkdocs-material/setup/setting-up-site-search/#built-in-search).
6366
* `icon` is an optional parameter (defaults to `library`) that selects the main top-left icon of the documentation website. Can be one of the icons from [Material Design Icons](https://materialdesignicons.com).
6467
* `primary-color` is an optional parameter (defaults to `indigo`) that selects the main color of the documentation website. For more information, see the [docs](https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#primary-color).
6568
* `secondary-color` is an optional parameter (defaults to `indigo`) that selects the accent color of the documentation website. For more information, see the [docs](https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#accent-color).
69+
* `hide-repository` is an optional parameter (defaults to `false`) that, if set to `true`, will hide every reference to the source repo. Useful for private repos.
6670

6771
### As Docker builder
6872
To use **markdown-docs** as a Docker builder stage use the following syntax in your Dockerfile:
@@ -84,13 +88,14 @@ There are some environment variables that control the behaviour of the builder.
8488
```dockerfile
8589
ENV WORKSPACE=/home
8690
# Optionals (with their default values)
91+
ENV TITLE=Markdown Docs
8792
ENV LANGUAGE=en
8893
ENV ICON=library
8994
ENV PRIMARY_COLOR=indigo
9095
ENV SECONDARY_COLOR=indigo
9196
```
9297
* `WORKSPACE` selects the path in which the main script is run. This path should be the root of your working directory, inside which there are both the source folder and the destination folder.
93-
* `LANGUAGE`, `ICON`, `PRIMARY_COLOR`, `SECONDARY_COLOR` are all described in [this section](#additional-parameters-info).
98+
* `TITLE`, `LANGUAGE`, `ICON`, `PRIMARY_COLOR`, `SECONDARY_COLOR` are all described in [this section](#additional-parameters-info).
9499

95100

96101
## Notes about documenting your software

action.yml

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,14 +44,26 @@ inputs:
4444
Default: indigo
4545
required: false
4646
default: indigo
47+
hide-repository:
48+
description: >
49+
If set to true, will generate a website that doesn't link back to the repository on GitHub. Defaults to false.
50+
required: false
51+
default: 'false'
52+
title:
53+
description: >
54+
The title for the documentation website. Defaults to the name of the repository.
55+
required: false
56+
default: ${{ github.repository }}
4757
runs:
4858
using: 'docker'
49-
image: 'docker://deloo/markdown-docs'
59+
image: 'docker://deloo/markdown-docs:0.6.0'
5060
env:
61+
TITLE: ${{ inputs.title }}
5162
LANGUAGE: ${{ inputs.language }}
5263
ICON: ${{ inputs.icon }}
5364
PRIMARY_COLOR: ${{ inputs.primary-color }}
5465
SECONDARY_COLOR: ${{ inputs.secondary-color }}
66+
HIDE_REPOSITORY: ${{ inputs.hide-repository }}
5567
args:
5668
- ${{ inputs.src }}
5769
- ${{ inputs.dst }}

0 commit comments

Comments
 (0)