forked from tangly1024/NotionNext
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
56ffca1
commit 1d00151
Showing
1 changed file
with
52 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
# Contributing | ||
|
||
- [Setup](#setup) | ||
- [Creating new themes](#creating-new-themes) | ||
- [Adding localizations](#adding-localizations) | ||
|
||
Thanks for considering to contribute! | ||
|
||
## Setup | ||
|
||
To contribute to NotionNext, follow these steps: | ||
|
||
1. [Fork][fork] the repository to your GitHub account. | ||
2. Clone the repository to your device (or use something like Codespaces). | ||
3. Create a new branch in the repository. | ||
4. Make your modifications. | ||
5. Commit your modifications and push the branch. | ||
6. [Create a PR][pr] from the branch in your fork to NotionNext' `main` branch. | ||
|
||
This project is built with [Next.js][next.js] and `yarn` as the package manager. | ||
Here are some commands that you can use: | ||
|
||
- `yarn`: install dependencies | ||
- `yarn dev`: compile and hot-reload for development | ||
- `yarn build`: compile and minify for production | ||
- `yarn start`: serve the compiled build in production mode | ||
|
||
## Creating new themes | ||
|
||
If you want to submit your custom theme to NotionNext, copy a new folder in | ||
[`themes`][themes-dir] from [`example`][example]. The folder name will be the | ||
theme's key. | ||
|
||
## Adding localizations | ||
|
||
If your language is not yet supported by NotionNext, please contribute a | ||
localization! Follow these steps to add a new localization: | ||
|
||
1. Copy one of the [en-US.js][en-US.js] in [lang-dir][lang-dir] and rename the new | ||
directory into your language's code ( e.g. `zh-CN.js`). | ||
2. Start translating the strings. | ||
3. Add your language config to [lang.js][lang.js]. | ||
4. [Create a PR][pr] with your localization updates. | ||
|
||
[fork]: https://github.com/tangly1024/NotionNext/fork | ||
[pr]: https://github.com/tangly1024/NotionNext/compare | ||
[next.js]: https://github.com/vercel/next.js | ||
[themes-dir]: themes | ||
[example]: themes/example | ||
[lang-dir]: lib/lang | ||
[en-US.js]: lib/lang/en-US.js | ||
[lang.js]: lib/lang.js |