@tobi-or-not/docpress 0.8.3 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -9
- package/dist/cli.js +878 -691
- package/dist/cli.js.map +1 -1
- package/package.json +41 -47
- package/types/public/templates/theme/index.d.ts +0 -8
- package/types/src/cli.d.ts +0 -12
- package/types/src/commands/build.d.ts +0 -20
- package/types/src/commands/fetch.d.ts +0 -15
- package/types/src/commands/global.d.ts +0 -4
- package/types/src/commands/prepare.d.ts +0 -15
- package/types/src/lib/fetch.d.ts +0 -179
- package/types/src/lib/git.d.ts +0 -568
- package/types/src/lib/prepare.d.ts +0 -214
- package/types/src/lib/vitepress.d.ts +0 -11
- package/types/src/schemas/build.d.ts +0 -7
- package/types/src/schemas/fetch.d.ts +0 -25
- package/types/src/schemas/global.d.ts +0 -100
- package/types/src/schemas/prepare.d.ts +0 -22
- package/types/src/utils/commands.d.ts +0 -95
- package/types/src/utils/const.d.ts +0 -40
- package/types/src/utils/functions.d.ts +0 -130
- package/types/src/utils/logger.d.ts +0 -14
- package/types/src/utils/regex.d.ts +0 -4
- package/types/src/utils/templates.d.ts +0 -7
package/README.md
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# Docpress :zap:
|
|
2
2
|
|
|
3
|
-
This project aims to automate the construction of documentation website based on a
|
|
3
|
+
This project aims to automate the construction of documentation website based on a GitHub or GitLab username and optionally a list of repositories.
|
|
4
4
|
|
|
5
5
|
## Explanation
|
|
6
6
|
|
|
7
|
-
Docpress automates the process of downloading documentation files from specified GitHub repositories. Here's how it works:
|
|
7
|
+
Docpress automates the process of downloading documentation files from specified GitHub or GitLab repositories. Here's how it works:
|
|
8
8
|
|
|
9
9
|
1. __Repository Documentation Retrieval__:
|
|
10
10
|
- The program checks if a `docs/` folder is present at the root level of each specified repository.
|
|
@@ -30,7 +30,7 @@ __Table of Contents__ *- md sources*:
|
|
|
30
30
|
1. Generate website using the Docpress docker image.
|
|
31
31
|
```sh
|
|
32
32
|
docker run --name docpress --rm -v $(pwd)/docpress:/app/docpress:rw \
|
|
33
|
-
ghcr.io/this-is-tobi/docpress -U <
|
|
33
|
+
ghcr.io/this-is-tobi/docpress -U <username>
|
|
34
34
|
```
|
|
35
35
|
> The dist folder is available at `./docpress/.vitepress/dist`, ready to be served by a web server like Nginx, Apache, etc...
|
|
36
36
|
|
|
@@ -56,7 +56,9 @@ Options:
|
|
|
56
56
|
-c, --extra-public-content <string> List of comma separated additional files or directories to process Vitepress public folder.
|
|
57
57
|
-C, --config <string> Path to the docpress configuration file.
|
|
58
58
|
-f, --forks Whether or not to create the dedicated fork page that aggregate external contributions.
|
|
59
|
-
-g, --git-provider <string> Git provider used to retrieve data.
|
|
59
|
+
-g, --git-provider <string> Git provider used to retrieve data.
|
|
60
|
+
Values should be "github" or "gitlab".
|
|
61
|
+
(default: "github")
|
|
60
62
|
-h, --help display help for command
|
|
61
63
|
-p, --extra-header-pages <string> List of comma separated additional files or directories to process Vitepress header pages.
|
|
62
64
|
-r, --repos-filter <string> List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories.
|
|
@@ -84,7 +86,7 @@ If you prefer Node.js package managers like npm, pnpm, or bun, you can easily in
|
|
|
84
86
|
|
|
85
87
|
To run Docpress using npm:
|
|
86
88
|
```sh
|
|
87
|
-
npx @tobi-or-not/docpress -U <
|
|
89
|
+
npx @tobi-or-not/docpress -U <username>
|
|
88
90
|
```
|
|
89
91
|
|
|
90
92
|
> [!TIP]
|
|
@@ -96,7 +98,7 @@ Docpress also provides a Docker image, which is especially useful if you want to
|
|
|
96
98
|
|
|
97
99
|
To run Docpress with Docker:
|
|
98
100
|
```sh
|
|
99
|
-
docker run --rm -v $(pwd)/docpress:/app/docpress:rw ghcr.io/this-is-tobi/docpress -U <
|
|
101
|
+
docker run --rm -v $(pwd)/docpress:/app/docpress:rw ghcr.io/this-is-tobi/docpress -U <username>
|
|
100
102
|
```
|
|
101
103
|
|
|
102
104
|
In this command:
|
|
@@ -127,12 +129,12 @@ To ensure that the program functions correctly, please follow these conventions:
|
|
|
127
129
|
|
|
128
130
|
### Link management
|
|
129
131
|
|
|
130
|
-
- Any inline link in the `./README.md` file that does not point to `./docs/**` will be replaced with the corresponding
|
|
131
|
-
- Similarly, any inline link in the `./docs/*.md` files that does not reference `./docs/**` will also be replaced with the appropriate
|
|
132
|
+
- Any inline link in the `./README.md` file that does not point to `./docs/**` will be replaced with the corresponding Git provider link.
|
|
133
|
+
- Similarly, any inline link in the `./docs/*.md` files that does not reference `./docs/**` will also be replaced with the appropriate Git provider link.
|
|
132
134
|
|
|
133
135
|
### Project descriptions
|
|
134
136
|
|
|
135
|
-
- The project description displayed on the home page of the generated website is extracted from the
|
|
137
|
+
- The project description displayed on the home page of the generated website is extracted from the repository's description on the Git provider.
|
|
136
138
|
|
|
137
139
|
---
|
|
138
140
|
|