Documentation

This commit is contained in:
squidfunk 2023-08-01 14:05:13 +02:00
parent a4c1b23912
commit 04b8d89baa
No known key found for this signature in database
GPG Key ID: 5ED40BC4F9C436DF

View File

@ -124,15 +124,30 @@ The following plugins are bundled with the Docker image:
Material for MkDocs only bundles selected plugins in order to keep the size Material for MkDocs only bundles selected plugins in order to keep the size
of the official image small. If the plugin you want to use is not included, of the official image small. If the plugin you want to use is not included,
create a `user-requirements.txt` file in the repository root with the packages you can add them easily:
you want to install additionally, e.g.:
``` txt title="user-requirements.txt" === "Material for MkDocs"
mkdocs-macros-plugin==0.7.0
mkdocs-glightbox>=0.3.1 Create a `Dockerfile` and extend the official image:
``` Dockerfile title="Dockerfile"
FROM squidfunk/mkdocs-material
RUN pip install mkdocs-macros-plugin
RUN pip install mkdocs-glightbox
``` ```
Next, you can build the image with the following command: === "Insiders"
Clone or fork the Insiders repository, and create a file called
`user-requirements.txt` in the root of the repository. Then, add the
plugins that should be installed to the file, e.g.:
``` txt title="user-requirements.txt"
mkdocs-macros-plugin
mkdocs-glightbox
```
Next, build the image with the following command:
``` ```
docker build -t squidfunk/mkdocs-material . docker build -t squidfunk/mkdocs-material .