mirror of
https://github.com/pi-hole/docs.git
synced 2025-12-24 13:18:55 +00:00
@@ -7,7 +7,7 @@ RUN apk add --no-cache \
|
||||
py3-pip \
|
||||
tzdata
|
||||
|
||||
ENV USER node
|
||||
ENV USER=node
|
||||
USER ${USER}
|
||||
|
||||
# python packages (as zensical) are installed in the user's home directory
|
||||
|
||||
@@ -16,7 +16,7 @@ trim_trailing_whitespace = true
|
||||
tab_width = 2
|
||||
|
||||
[*.md]
|
||||
tab_width = 2
|
||||
tab_width = 4
|
||||
trim_trailing_whitespace = false
|
||||
|
||||
[*.json]
|
||||
|
||||
2
.github/workflows/codespell.yml
vendored
2
.github/workflows/codespell.yml
vendored
@@ -17,4 +17,4 @@ jobs:
|
||||
uses: codespell-project/actions-codespell@8f01853be192eb0f849a5c7d721450e7a467c579 #v2.2
|
||||
with:
|
||||
ignore_words_file: .codespellignore
|
||||
skip: ./docs/routers/fritzbox-de.md,./mkdocs.yml,./package.json,./package-lock.json,./.markdownlint.json,./requirements.txt, ./MathJax-es5/*
|
||||
skip: ./docs/routers/fritzbox-de.md,./zensical.toml,./package.json,./package-lock.json,./.markdownlint.json,./requirements.txt
|
||||
|
||||
20
README.md
20
README.md
@@ -14,7 +14,7 @@ This repo is the source for the official [Pi-hole documentation](https://docs.pi
|
||||
|
||||
### How to contribute
|
||||
|
||||
To add a new link on the navigation panel you need to edit the `mkdocs.yml` file in the root of the repo. There is a guide for building the navbar [on the mkdocs wiki](https://www.mkdocs.org/user-guide/configuration/#nav)
|
||||
To add a new link on the navigation panel you need to edit the `zensical.toml` file in the root of the repo. There is a guide for building the navbar [on the zensical documentation](https://zensical.org/docs/setup/navigation/)
|
||||
|
||||
To add a new document or guide.
|
||||
|
||||
@@ -26,7 +26,7 @@ To add a new document or guide.
|
||||
|
||||
### Testing your changes
|
||||
|
||||
When working on this repo, it is advised that you review your changes locally before committing them. The `mkdocs serve` command can be used to live preview your changes (as you type) on your local machine.
|
||||
When working on this repo, it is advised that you review your changes locally before committing them. The `zensical serve` command can be used to live preview your changes (as you type) on your local machine.
|
||||
|
||||
Please make sure you fork the repo and change the clone URL in the example below for your fork:
|
||||
|
||||
@@ -51,7 +51,7 @@ Please make sure you fork the repo and change the clone URL in the example below
|
||||
- Running the docs server:
|
||||
|
||||
```bash
|
||||
mkdocs serve --dev-addr 0.0.0.0:8000
|
||||
zensical serve --dev-addr 0.0.0.0:8000
|
||||
```
|
||||
|
||||
- Fedora Linux instructions (tested on Fedora Linux 28):
|
||||
@@ -66,20 +66,12 @@ Please make sure you fork the repo and change the clone URL in the example below
|
||||
- Running the docs server:
|
||||
|
||||
```bash
|
||||
mkdocs serve --dev-addr 0.0.0.0:8000
|
||||
zensical serve --dev-addr 0.0.0.0:8000
|
||||
```
|
||||
|
||||
- Docker instructions:
|
||||
- One-shot run:
|
||||
- Docker devcontainer instructions:
|
||||
- We provide a `devcontainer.json` and a dockerfile which will setup the required development environment for an easy deployment. Devcontainers can be used with various editors, e.g. VS Code
|
||||
|
||||
```bash
|
||||
docker run -v `pwd`:/opt/app/ -w /opt/app/ -p 8000:8000 -it nikolaik/python-nodejs:python3.7-nodejs16 \
|
||||
sh -c "pip install --user -r requirements.txt && \
|
||||
/root/.local/bin/mkdocs build && \
|
||||
npm ci && \
|
||||
npm test && \
|
||||
/root/.local/bin/mkdocs serve --dev-addr 0.0.0.0:8000"
|
||||
```
|
||||
|
||||
After these commands, the current branch is accessible through your favorite browser at <http://localhost:8000>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user