Newer
Older
# [casdoor.org](https://casdoor.org) [![Build and Deploy](https://github.com/casdoor/casdoor-website/actions/workflows/master.yml/badge.svg)](https://github.com/casdoor/casdoor-website/actions/workflows/master.yml)
The configuration and documentation of Casdoor website: <https://casdoor.org/>.
Casdoor website is built using [Docusaurus](https://docusaurus.io/), you can get the PDF at [casdoor.org/pdf](https://casdoor.org/pdf/) or [GitHub Action](https://github.com/casdoor/casdoor-website/actions/workflows/master.yml).
1. [Git](https://git-scm.com/downloads)
2. [Node.js](https://nodejs.org/en/download/):v16.14 or above
3. [Yarn](https://classic.yarnpkg.com/en/docs/install): please use Yarn 1
1. `git clone https://github.com/casdoor/casdoor-website.git`
2. `cd casdoor-website`
3. `yarn`: install dependencies.
4. `yarn start`: starting the development server.
You can contribute to the documentation site in different ways: [Documentation Writing](#documentation-writing), [Translation](#translation), [Website Development](#website-development).
For the configuration of the sidebar, you can refer to [Sidebar](https://docusaurus.io/docs/sidebar).
For the features that you may use when writing documents, please refer to [Markdown Features](https://docusaurus.io/docs/markdown-features).
````md
---
title: Title
description: description
keywords: [keyword1, keyword2]
---
You can add [Admonitions](https://docusaurus.io/docs/markdown-features/admonitions) in the documentation, but please leave two blank lines like this:
You can use JSX in documents, such as the [Tabs](https://docusaurus.io/docs/markdown-features/tabs) component provided by Docusaurus, but to prevent Crowdin from breaking the code ([mdx-solutions](https://docusaurus.io/docs/i18n/crowdin#mdx-solutions)), please wrap the JSX code:
````mdx-code-block
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
[Crowdin](https://crowdin.com/project/casdoor-website) and [Docusaurus i18n](https://docusaurus.io/docs/i18n/introduction) 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](https://github.com/casdoor/casdoor-website/issues/305)).
See [Creating Pages](https://docusaurus.io/docs/creating-pages) to learn how to create a page.
See [Styling and Layout](https://docusaurus.io/docs/styling-layout) to learn how to modify styles.
See [Swizzling](https://docusaurus.io/docs/swizzling) to learn how to modify Docusaurus built-in components.