rnx-kit/docsite/README.md

46 строки
770 B
Markdown
Исходник Обычный вид История

Documentation Website (#1197) * working docusaurus site. mostly stock with a few minor tweaks. * set light/dark mode colors * Update README main header link. Add GitHub logo (light and dark mode variants) to docsite header bar. * accessibility fixes * Clear out footer, leaving copyright. Always use darktheme when showing code to fix contrast issues. Change github icon to inline SVG. Add examples of Important and Caution blocks in markdown. Change link colors to match RNW and RN sites. * Move into doc into hierarchy (styles don't support top-level docs). Reinstate homepage feature area, which now appears to be a little broken. * Add MS Open Source img and link as footer logo. Also tweak CSS: inline code formatting in markdown, color refining/sharing, footer logo size/opacity. * Remove opacity styles on footer -- they happen automatically since it is a link. * Finalize landing page. Move GitHub logo into an .svg file. * Fix editUrls. * fix homepage text * Add local-search support and styling. Not too happy with this. Out of the box, local search uses Algolia's color scheme and doesn't pick up Docusaurus colors. I have it polished and working, though. Going to try using the DocSearch-based service instead which is supposed to integrate w/Docusaurus CSS vars. * Update docusaurus version * Create navbar hierarchy and matching sidebars. Remove inline front-matter tags and category files, and instead be get name from markdown title and order from sidebar.js. * Use a very dark gray background instead of black in darkmode. Fix typo in navbar. * add shadow on navbar in darkmode * Remove sample content * docs(changeset): Documentation site framework and theming. No content yet other than the landing page. * yarn deduplicate * update dup checker tests -- they are sensitive to the yarn dependency graph in this repo * align dependencies
2022-03-08 20:30:14 +03:00
# Website
This website is built using [Docusaurus 2](https://docusaurus.io/), a modern
static website generator.
Documentation Website (#1197) * working docusaurus site. mostly stock with a few minor tweaks. * set light/dark mode colors * Update README main header link. Add GitHub logo (light and dark mode variants) to docsite header bar. * accessibility fixes * Clear out footer, leaving copyright. Always use darktheme when showing code to fix contrast issues. Change github icon to inline SVG. Add examples of Important and Caution blocks in markdown. Change link colors to match RNW and RN sites. * Move into doc into hierarchy (styles don't support top-level docs). Reinstate homepage feature area, which now appears to be a little broken. * Add MS Open Source img and link as footer logo. Also tweak CSS: inline code formatting in markdown, color refining/sharing, footer logo size/opacity. * Remove opacity styles on footer -- they happen automatically since it is a link. * Finalize landing page. Move GitHub logo into an .svg file. * Fix editUrls. * fix homepage text * Add local-search support and styling. Not too happy with this. Out of the box, local search uses Algolia's color scheme and doesn't pick up Docusaurus colors. I have it polished and working, though. Going to try using the DocSearch-based service instead which is supposed to integrate w/Docusaurus CSS vars. * Update docusaurus version * Create navbar hierarchy and matching sidebars. Remove inline front-matter tags and category files, and instead be get name from markdown title and order from sidebar.js. * Use a very dark gray background instead of black in darkmode. Fix typo in navbar. * add shadow on navbar in darkmode * Remove sample content * docs(changeset): Documentation site framework and theming. No content yet other than the landing page. * yarn deduplicate * update dup checker tests -- they are sensitive to the yarn dependency graph in this repo * align dependencies
2022-03-08 20:30:14 +03:00
### Installation
```
$ yarn
```
### Local Development
```
$ yarn start
```
This command starts a local development server and opens up a browser window.
Most changes are reflected live without having to restart the server.
Documentation Website (#1197) * working docusaurus site. mostly stock with a few minor tweaks. * set light/dark mode colors * Update README main header link. Add GitHub logo (light and dark mode variants) to docsite header bar. * accessibility fixes * Clear out footer, leaving copyright. Always use darktheme when showing code to fix contrast issues. Change github icon to inline SVG. Add examples of Important and Caution blocks in markdown. Change link colors to match RNW and RN sites. * Move into doc into hierarchy (styles don't support top-level docs). Reinstate homepage feature area, which now appears to be a little broken. * Add MS Open Source img and link as footer logo. Also tweak CSS: inline code formatting in markdown, color refining/sharing, footer logo size/opacity. * Remove opacity styles on footer -- they happen automatically since it is a link. * Finalize landing page. Move GitHub logo into an .svg file. * Fix editUrls. * fix homepage text * Add local-search support and styling. Not too happy with this. Out of the box, local search uses Algolia's color scheme and doesn't pick up Docusaurus colors. I have it polished and working, though. Going to try using the DocSearch-based service instead which is supposed to integrate w/Docusaurus CSS vars. * Update docusaurus version * Create navbar hierarchy and matching sidebars. Remove inline front-matter tags and category files, and instead be get name from markdown title and order from sidebar.js. * Use a very dark gray background instead of black in darkmode. Fix typo in navbar. * add shadow on navbar in darkmode * Remove sample content * docs(changeset): Documentation site framework and theming. No content yet other than the landing page. * yarn deduplicate * update dup checker tests -- they are sensitive to the yarn dependency graph in this repo * align dependencies
2022-03-08 20:30:14 +03:00
### Build
```
$ yarn build
```
This command generates static content into the `build` directory and can be
served using any static contents hosting service.
Documentation Website (#1197) * working docusaurus site. mostly stock with a few minor tweaks. * set light/dark mode colors * Update README main header link. Add GitHub logo (light and dark mode variants) to docsite header bar. * accessibility fixes * Clear out footer, leaving copyright. Always use darktheme when showing code to fix contrast issues. Change github icon to inline SVG. Add examples of Important and Caution blocks in markdown. Change link colors to match RNW and RN sites. * Move into doc into hierarchy (styles don't support top-level docs). Reinstate homepage feature area, which now appears to be a little broken. * Add MS Open Source img and link as footer logo. Also tweak CSS: inline code formatting in markdown, color refining/sharing, footer logo size/opacity. * Remove opacity styles on footer -- they happen automatically since it is a link. * Finalize landing page. Move GitHub logo into an .svg file. * Fix editUrls. * fix homepage text * Add local-search support and styling. Not too happy with this. Out of the box, local search uses Algolia's color scheme and doesn't pick up Docusaurus colors. I have it polished and working, though. Going to try using the DocSearch-based service instead which is supposed to integrate w/Docusaurus CSS vars. * Update docusaurus version * Create navbar hierarchy and matching sidebars. Remove inline front-matter tags and category files, and instead be get name from markdown title and order from sidebar.js. * Use a very dark gray background instead of black in darkmode. Fix typo in navbar. * add shadow on navbar in darkmode * Remove sample content * docs(changeset): Documentation site framework and theming. No content yet other than the landing page. * yarn deduplicate * update dup checker tests -- they are sensitive to the yarn dependency graph in this repo * align dependencies
2022-03-08 20:30:14 +03:00
### Deployment
Using SSH:
```
$ USE_SSH=true yarn deploy
```
Not using SSH:
```
$ GIT_USER=<Your GitHub username> yarn deploy
```
If you are using GitHub pages for hosting, this command is a convenient way to
build the website and push to the `gh-pages` branch.