Easy to maintain open source documentation websites.
Find a file
Fienny Angelina a1d36be61c fix: make referenced links work with code block tabs (#1249)
* Fix bug Code block tabs broke the referenced links

- The reason is that the previous Codeblock implementation separates
the tabs, the markdown before tabs, and the markdown after tabs into
separate Remarkable component, thus they don't share information
regarding the reference link
- To solve this, change the Doc implementation so that one Doc
have only one Remarkable component by transforming the codeblock
into html string and add it as part of the markdown, letting the
Remarkable take care of the html string
- However, this approach made us need to ensure that there is no
newline in the codetab, otherwise, the formatting inside the
code will be broken. Thus, I replace every newline inside the
code tag with a br tag

Fix #1215

* Fix prettier
2019-02-26 08:56:30 -08:00
.circleci fix(v2): fix CI path error 2019-02-24 14:24:24 -08:00
.github chore: automate request for review on v2 2018-09-25 20:33:52 +08:00
admin chore: update prerelease.sh & prerelease.md (#886) 2018-08-03 20:24:09 +08:00
docs refactor(v2): move website dir out of v2 for cleaner separations 2019-02-24 14:13:08 -08:00
scripts chore(v1): add Facebook copyright headers (#1068) 2018-10-25 17:30:38 -07:00
v1 fix: make referenced links work with code block tabs (#1249) 2019-02-26 08:56:30 -08:00
v2 fix(v2): s/blogMetadatas/blogMetadata 2019-02-24 23:33:08 -08:00
v2-website feat(v2): create docusaurus-content-blog plugin draft 2019-02-24 23:11:15 -08:00
.editorconfig Standardize editor configs for cross-platform development (#628) 2018-05-03 10:23:21 -07:00
.gitattributes Add .webp to .gitattributes for ignoring 2018-05-03 13:13:03 -07:00
.gitignore refactor(v2): shift generated files out of core into website dir 2019-02-24 15:20:58 -08:00
.prettierignore refactor(v2): shift generated files out of core into website dir 2019-02-24 15:20:58 -08:00
.prettierrc Prettify all JavaScript files (#964) 2018-09-17 15:34:55 +08:00
.watchmanconfig Add first set of docusaurus-build tests using Jest (#259) 2017-12-18 14:40:52 -08:00
CHANGELOG.md v1.7.2 (#1212) 2019-01-28 22:18:12 -08:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2018-07-31 19:49:46 -07:00
CONTRIBUTING.md Update code.facebook.com links to appropriate new destination (#1224) 2019-02-06 14:29:17 -08:00
LICENSE The complete move to MIT license (#115) 2017-10-05 11:14:49 -07:00
LICENSE-docs Docusaurus documentation license (#118) 2017-10-06 12:59:01 -07:00
package.json chore: upgrade husky to 1.3.1 (#1229) 2019-02-12 10:34:31 +08:00
README.md Remove more references to code.facebook.com (#1231) 2019-02-12 12:20:44 -08:00
yarn.lock chore: upgrade husky to 1.3.1 (#1229) 2019-02-12 10:34:31 +08:00

Docusaurus

Docusaurus

npm version CircleCI Status PRs Welcome Chat code style: prettier Tested with Jest

Introduction

Docusaurus is a project for easily building, deploying, and maintaining open source project websites.

  • Simple to Start Docusaurus is built to be easy to get up and running in as little time possible. We've built Docusaurus to handle the website build process so you can focus on your project.
  • Localizable Docusaurus ships with localization support via CrowdIn. Empower and grow your international community by translating your documentation.
  • Customizable While Docusaurus ships with the key pages and sections you need to get started, including a home page, a docs section, a blog, and additional support pages, it is also customizable as well to ensure you have a site that is uniquely yours.

Installation

Docusaurus is available as the docusaurus package on npm.

We have also released the docusaurus-init package to make getting started with Docusaurus even easier.

Contributing

We've released Docusaurus because it helps us better scale and support the many OSS projects at Facebook. We hope that other organizations can benefit from the project. We are thankful for any contributions from the community.

Code of Conduct

Facebook has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Docusaurus.

Beginner Friendly Bugs

To help you get your feet wet and get you familiar with our contribution process, we have a list of beginner friendly bugs that contain bugs which are fairly easy to fix. This is a great place to get started.

Contact

We have a few channels for contact:

  • Discord with two text channels:
    • #docusaurus-users for those using Docusaurus.
    • #docusaurus-dev for those wanting to contribute to the Docusaurus core.
  • @docusaurus on Twitter
  • GitHub Issues

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

License

Docusaurus is MIT licensed.

The Docusaurus documentation (e.g., .md files in the /docs folder) is Creative Commons licensed.