The configuration and documentation of Casdoor website: https://casdoor.org/.
Casdoor website is built using Docusaurus, you can get the PDF at casdoor.org/pdf or GitHub Action.
git clone https://github.com/casdoor/casdoor-website.gitcd casdoor-websiteyarn: install dependencies.yarn start: starting the development server.
You can contribute to the documentation site in different ways: Documentation Writing, Translation, Website Development.
For the configuration of the sidebar, you can refer to Sidebar.
For the features that you may use when writing documents, please refer to Markdown Features.
A standard document should look like this:
---
title: Title
description: description
keywords: [keyword1, keyword2]
---
## Headers
Only h2 and h3 will be in the TOC by default.
### h3
content
#### h4
content
You can add Admonitions in the documentation, but please leave two blank lines like this:
:::info Title
Title is optional
:::You can use JSX in documents, such as the Tabs component provided by Docusaurus, but to prevent Crowdin from breaking the code (mdx-solutions), please wrap the JSX code:
```mdx-code-block
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
```
```mdx-code-block
<Tabs>
<TabItem value="go" label="Go">
```
content
```mdx-code-block
</TabItem>
<TabItem value="java" label="Java">
```
content
```mdx-code-block
</TabItem>
</Tabs>
```
Crowdin and Docusaurus i18n is used for Casdoor website's translation.
Note: Please do not translate strings like :::note, :::tip, wrong translation may cause typographical error(casdoor-website#305).
You may see some sentences containing {}, like:
At our {repoLink}, browse and submit {issueLink} or {prLink} for bugs you find or any new features you may want implemented.
Please do not translate {repoLink} or {issueLink} or any similar words, they are interpolation placeholders.
See Creating Pages to learn how to create a page.
See Styling and Layout to learn how to modify styles.
See Swizzling to learn how to modify Docusaurus built-in components.