tiktok-sparo/apps/website/README.md

76 lines
2.2 KiB
Markdown
Raw Normal View History

# Website
2024-02-22 02:48:30 -05:00
This is the [Docusaurus](https://docusaurus.io/) project for the Sparo website.
2024-02-22 02:48:30 -05:00
## Development
2024-02-22 02:48:30 -05:00
1. Install the monorepo dependencies using [RushJS](https://rushjs.io/):
2024-02-22 02:48:30 -05:00
```shell
rush install
rush build
```
2024-02-22 02:48:30 -05:00
2. Launch the local development server:
```shell
cd apps/website
rushx 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.
2024-02-27 00:27:10 -05:00
### Site search
Because this site is relatively small, searching is performed client-side using the [docusaurus-lunr-search](https://www.npmjs.com/package/docusaurus-lunr-search) plugin based on [Lunr.js](https://lunrjs.com/).
Notes:
- Site search is broken when using the localhost debug server (`rushx start`), but it works correctly for real deployments (`rushx deploy`)
- `@algolia/client-search` is included in **package.json** dependencies only because `@docusaurus/preset-classic` includes it as a peer dependency.
2024-08-22 16:40:37 -04:00
## Managing translations
Instructions for internationalization with Docusaurus: https://docusaurus.io/docs/i18n/introduction
The supported locales for this project can be found in the `"i18n"` section of
[docusaurus.config.js](./docusaurus.config.js).
> **NOTE:** Each locale is built as a distinct standalone single-page application. The localhost
> dev server builds only one locale at a time. To view multiple locales together, you must deploy
> the site.
Common commands:
- `rushx start --locale zh-cn` - launch the localhost dev server in the specified language.
- `rushx write-translations --locale zh-cn` - Update the `i18n/*.json` files with any new strings.
2024-02-22 02:48:30 -05:00
## Deployment
2024-02-22 02:48:30 -05:00
1. If you will manually copy the files to a server, you can build the **apps/sparo/build** folder like this:
2024-02-22 02:48:30 -05:00
```shell
cd apps/website
rushx build
```
2024-02-22 02:48:30 -05:00
2. To automatically deploy to GitHub Pages (as an administrator):
2024-02-22 02:48:30 -05:00
```shell
# If you are using HTTPS authentication for GitHub:
cd apps/website
GIT_USER=<Your GitHub username> rushx deploy
```
2024-02-22 02:48:30 -05:00
```
# If you are using SSH authentication for GitHub:
USE_SSH=true rushx deploy
```
2024-02-22 02:48:30 -05:00
## See also
2024-02-22 02:48:30 -05:00
- [Deployment](https://docusaurus.io/docs/deployment) from the Docusaurus help