Update docs README.md and config
(this is embarrasing)
This commit is contained in:
parent
ea31c64674
commit
a73ccc0305
GPG key ID:
E366BAEF67E4704D
2 changed files with 4 additions and 91 deletions
|
|
@ -1,116 +1,29 @@
|
|||
# Presencode documentation
|
||||
The Presencode documentation uses [Docusaurus](https://docusaurus.io).
|
||||
# CORE Framework documentation
|
||||
The CORE Framework documentation uses [Docusaurus](https://docusaurus.io).
|
||||
|
||||
# Commands
|
||||
We use [make](https://www.gnu.org/software/make/).
|
||||
## Installing dependencies
|
||||
```plain
|
||||
$ make install-deps
|
||||
pnpm install
|
||||
Downloading registry.npmjs.org/typescript/5.2.2: 7,23 MB/7,23 MB, done
|
||||
WARN 1 deprecated subdependencies found: stable@0.1.8
|
||||
Packages: +1088
|
||||
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
||||
Progress: resolved 1089, reused 0, downloaded 1088, added 1088, done
|
||||
node_modules/.pnpm/core-js-pure@3.35.0/node_modules/core-js-pure: Running postinstall script, done in 92ms
|
||||
node_modules/.pnpm/core-js@3.35.0/node_modules/core-js: Running postinstall script, done in 92ms
|
||||
|
||||
dependencies:
|
||||
+ @docusaurus/core 3.1.0
|
||||
+ @docusaurus/plugin-content-docs 3.1.0
|
||||
+ @docusaurus/plugin-sitemap 3.1.0
|
||||
+ @docusaurus/preset-classic 3.1.0
|
||||
+ @mdx-js/react 3.0.0
|
||||
+ clsx 2.1.0
|
||||
+ prism-react-renderer 2.3.1
|
||||
+ react 18.2.0
|
||||
+ react-dom 18.2.0
|
||||
|
||||
devDependencies:
|
||||
+ @docusaurus/module-type-aliases 3.1.0
|
||||
+ @docusaurus/tsconfig 3.1.0
|
||||
+ @docusaurus/types 3.1.0
|
||||
+ typescript 5.2.2 (5.3.3 is available)
|
||||
|
||||
Done in 18.1s
|
||||
```
|
||||
## Development web server
|
||||
This will start [a development server](http://localhost:3000) that supports hot reloading.
|
||||
```plain
|
||||
$ make test
|
||||
pnpm run start --hot-only --no-open
|
||||
|
||||
> docs@0.0.0 start /home/jeremystartm/Code/JeremyStarTM/Presencode/docs
|
||||
> docusaurus start "--hot-only" "--no-open"
|
||||
|
||||
(node:138150) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
|
||||
(Use `node --trace-deprecation ...` to show where the warning was created)
|
||||
[INFO] Starting the development server...
|
||||
[SUCCESS] Docusaurus website is running at: http://localhost:3000/
|
||||
|
||||
✔ Client
|
||||
Compiled successfully in 4.40s
|
||||
|
||||
client (webpack 5.89.0) compiled successfully
|
||||
```
|
||||
## Building the documentation
|
||||
This will output the built documentation to `out/`. Simply point a web server to it and you're done.
|
||||
```plain
|
||||
$ make build
|
||||
pnpm run build --out-dir out
|
||||
|
||||
> docs@0.0.0 build /home/jeremystartm/Code/JeremyStarTM/Presencode/docs
|
||||
> docusaurus build "--out-dir" "out"
|
||||
|
||||
(node:139592) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
|
||||
(Use `node --trace-deprecation ...` to show where the warning was created)
|
||||
[INFO] [en] Creating an optimized production build...
|
||||
|
||||
|
||||
✔ Client
|
||||
|
||||
|
||||
✔ Server
|
||||
Compiled successfully in 11.36s
|
||||
|
||||
|
||||
✔ Client
|
||||
|
||||
|
||||
● Server █████████████████████████ cache (99%) shutdown IdleFileCachePlugin
|
||||
stored
|
||||
|
||||
[SUCCESS] Generated static files in "out".
|
||||
[INFO] Use `npm run serve` command to test your build locally
|
||||
```
|
||||
## Cleaning the directory
|
||||
This will remove the `out/` directory containing the built website aswell as Docusaurus files.
|
||||
```plain
|
||||
$ make clean
|
||||
pnpm run clear
|
||||
|
||||
> docs@0.0.0 clear /home/jeremystartm/Code/JeremyStarTM/Presencode/docs
|
||||
> docusaurus clear
|
||||
|
||||
(node:140318) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
|
||||
(Use `node --trace-deprecation ...` to show where the warning was created)
|
||||
[SUCCESS] Removed the generated folder at "/home/jeremystartm/Code/JeremyStarTM/Presencode/docs/.docusaurus".
|
||||
[SUCCESS] Removed the Webpack persistent cache folder at "/home/jeremystartm/Code/JeremyStarTM/Presencode/docs/node_modules/.cache".
|
||||
rm -rf "out" ".docusaurus" ".cache-loader"
|
||||
```
|
||||
### More cleaning
|
||||
This will remove the `node_modules/` and `pnpm-lock.yaml` directory aswell.
|
||||
```plain
|
||||
$ make clean-extra
|
||||
pnpm run clear
|
||||
|
||||
> docs@0.0.0 clear /home/jeremystartm/Code/JeremyStarTM/Presencode/docs
|
||||
> docusaurus clear
|
||||
|
||||
(node:141571) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
|
||||
(Use `node --trace-deprecation ...` to show where the warning was created)
|
||||
[SUCCESS] Removed the generated folder at "/home/jeremystartm/Code/JeremyStarTM/Presencode/docs/.docusaurus".
|
||||
[SUCCESS] Removed the Webpack persistent cache folder at "/home/jeremystartm/Code/JeremyStarTM/Presencode/docs/node_modules/.cache".
|
||||
rm -rf "out" ".docusaurus" ".cache-loader"
|
||||
rm -rf "node_modules" "pnpm-lock.yaml"
|
||||
```
|
||||
|
|
@ -4,7 +4,7 @@ import type * as Preset from "@docusaurus/preset-classic";
|
|||
|
||||
const config: Config = {
|
||||
title: "CORE Framework",
|
||||
url: "https://core.jstm.staropensource.de",
|
||||
url: "https://core.staropensource.de",
|
||||
baseUrl: "/",
|
||||
|
||||
favicon: "dist/core.png",
|
||||
|
|
|
|||
Loading…
Reference in a new issue