-
Clone this repo;
-
Install dependent:
- Run
yarn;
- Download docs:
- Run
git submodule init; - Run
git submodule update --depth 1 --remote;
Run yarn start to develop:
yarn startIn order to debug algolia searches, you need to provide two additional environment variables:
GATSBY_ALGOLIA_APPLICATION_IDGATSBY_ALGOLIA_API_KEY
Put them in .env.development to make them take effect. (Ref: https://www.gatsbyjs.com/docs/how-to/local-development/environment-variables/)
Because of most of our text data stored in GitHub. It's needed to apply a GitHub API token in development when you are prompted for rate-limiting.
For more details, view https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting.
You must set the token as an env when you start some commands, defined as:
GITHUB_AUTHORIZATION_TOKEN=tokenFor better collaboration and review, we have developed a few rules to help us develop better.
Before you contribute, you must read the following carefully.
First, we use husky and lint-staged to make prettier format our code automatically before commit.
And also, because some of us use vscode to develop, we recommend to use sort-imports to format all imports. (This is optional, we will not force you to use)
Currently, we use sass to style each pages and components.
We hope you can follow this order (Don't care about their value) to organize all styles:
// Position first
position: relative;
top: 0;
bottom: 0;
left: 0;
right: 0;
// Then display
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
// Layout
width: 0;
height: 0;
margin: 0;
padding: 0;
// Colors
background: #fff;
color: #000;
// Outside
border: 0;
box-shadow: none;
// Finally, not often used values can be in any orderDon't include no used deps.
Don't let your code be too long-winded, there will be a lot of elegant writing.
Every new features must have a unit test.
Currently, you can use these shortcodes into docs:
<Note>This is a note.</Note>
<Warning>This is a warning.</Warning>
<Tip>This is a tip.</Tip>
<Error>This is an error.</Error>
<Important>This is an important message.</Important>Everything you need is just to write a JSX tag, put the text into it. Then we will use mdx to convert it to JS code.
Use <SimpleTab> to create a tab panel. Do not put any h1 ~ h3 headings inside the tab panel.
<SimpleTab>
<div label="LABEL_SHOW_ON_FIRST_TAB">
This is the first content, which is markdown format. The content will show
on the corresponding panel when users switch the tabs.
</div>
<div label="LABEL_SHOW_ON_SECOND_TAB">This is the second content.</div>
</SimpleTab>Edit file _index.md in each doc repo to custom its landing page.
All columns have to be wrapped by tag <NavColumns></NavColumns>, each column has to be wrapped by tag <NavColumn></NavColumn>and column title has to be wrapped by tag <ColumnTitle></ColumnTitle>. For example:
<NavColumns>
<NavColumn>
<ColumnTitle>Column title</ColumnTitle>- [This is nav](/fileName.md) - [This
is nav](/fileName.md) - [This is nav](/fileName.md) - [This is
nav](/fileName.md)
</NavColumn>
<NavColumn>
<ColumnTitle>Column title</ColumnTitle>- [This is nav](/fileName.md) - [This
is nav](/fileName.md) - [This is nav](/fileName.md) - [This is
nav](/fileName.md)
</NavColumn>
</NavColumns>MIT
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent