actions/dockerhub-description
actions/dockerhub-description
3
0
Fork 0
mirror of https://github.com/peter-evans/dockerhub-description.git synced 2024-11-21 19:49:32 +01:00
Code Issues Projects Activity Pipelines

docs: minor documentation updates

Browse source
This commit is contained in:
Peter Evans 2023-03-05 11:19:28 +09:00
parent e139363f61
commit 79b63455c0
2 changed files with 19 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

34
README.md
View file

@ -25,7 +25,7 @@ This is useful if you `docker push` your images to Docker Hub. It provides an ea
| `repository` | Docker Hub repository in the format `<namespace>/<name>`. | `github.repository` |
| `short-description` | Docker Hub repository short description. | |
| `readme-filepath` | Path to the repository readme. | `./README.md` |
| `enable-url-completion` | Enables completion of relative URLs to absolute ones. See also [Known Issues](#known-issues). | `false` |
| `enable-url-completion` | Enables completion of relative URLs to absolute ones. See also [known Issues](#url-completion-known-issues). | `false` |
| `image-extensions` | File extensions that will be treated as images. | `bmp,gif,jpg,jpeg,png,svg,webp` |
#### Content limits
@ -111,23 +111,9 @@ jobs:
short-description: ${{ github.event.repository.description }}
```
## Using the Docker image independently of GitHub Actions
### URL completion known Issues
The image can be executed in other environments independently of GitHub Actions.
Simply volume mount the location of the `README.md` file to the container and set environment variables as follows.
```bash
docker run -v $PWD:/workspace \
-e DOCKERHUB_USERNAME='user1' \
-e DOCKERHUB_PASSWORD='xxxxx' \
-e DOCKERHUB_REPOSITORY='user1/my-docker-image' \
-e README_FILEPATH='/workspace/README.md' \
peterevans/dockerhub-description:3
```
## Known Issues
The completion of relative urls has some known issues:
The completion of relative URLs has some known issues:
1. Relative markdown links in inline-code and code blocks **are also converted**:
@ -157,6 +143,20 @@ The completion of relative urls has some known issues:
[toc]: #table-of-content "Table of content"
```
## Using the Docker image independently of GitHub Actions
The image can be executed in other environments independently of GitHub Actions.
Simply volume mount the location of the `README.md` file to the container and set environment variables as follows.
```bash
docker run -v $PWD:/workspace \
-e DOCKERHUB_USERNAME='user1' \
-e DOCKERHUB_PASSWORD='xxxxx' \
-e DOCKERHUB_REPOSITORY='user1/my-docker-image' \
-e README_FILEPATH='/workspace/README.md' \
peterevans/dockerhub-description:3
```
## License
[MIT](LICENSE)

4
action.yml
View file

@ -20,11 +20,11 @@ inputs:
Default: `./README.md`
enable-url-completion:
description: >
Enables completion of relative urls to absolute ones
Enables completion of relative URLs to absolute ones
Default: `false`
image-extensions:
description: >
Extensions of files that you be treated as images
File extensions that will be treated as images
Default: `bmp,gif,jpg,jpeg,png,svg,webp`
runs:
using: 'node16'