b14073a9e2
|
||
|---|---|---|
| .github | ||
| docs | ||
| i18n | ||
| src | ||
| static | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| babel.config.js | ||
| docusaurus.config.js | ||
| package-lock.json | ||
| package.json | ||
| sidebars.js | ||
README.md
Website
This website is built using Docusaurus 2 with below command:
npx create-docusaurus@latest myems.io classic
Please ignore above command and start from below command.
Download all the necessary dependencies into the node_modules directory.
cd myems.io
sudo npm i --unsafe-perm=true --allow-root --legacy-peer-deps
Build
Docusaurus is a modern static website generator so we need to build the website into a directory of static contents and put it on a web server so that it can be viewed. To build the website:
sudo npm run build
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Running the development server
To preview your changes as you edit the files, you can run a local development server that will serve your website and reflect the latest changes.
cd myems.io
sudo npm run serve
By default, a browser window will open at http://localhost:3000.
Deployment with Azure Static Web Apps CI/CD
A GitHub Actions workflow is triggered when a push to master branch or a pull request on the master branch is: opened, synchronized, reopened, or closed.
Refer to https://dev.to/azure/11-share-content-with-docusaurus-azure-static-web-apps-30hc
Translate
Use the write-translations CLI command to initialize the JSON translation files for the zh-Hans locale:
sudo npm run write-translations -- --locale zh-Hans
Copy your untranslated Markdown files to the zh-Hans folder:
mkdir -p i18n/zh-Hans/docusaurus-plugin-content-docs/current
cp -r docs/** i18n/zh-Hans/docusaurus-plugin-content-docs/current
mkdir -p i18n/zh-Hans/docusaurus-plugin-content-blog
cp -r blog/** i18n/zh-Hans/docusaurus-plugin-content-blog
mkdir -p i18n/zh-Hans/docusaurus-plugin-content-pages
cp -r src/pages/**.md i18n/zh-Hans/docusaurus-plugin-content-pages
cp -r src/pages/**.mdx i18n/zh-Hans/docusaurus-plugin-content-pages
Add all these files to Git.
Translate the Markdown and JSON files in i18n/zh-Hans and commit the translation.
Repeat
Follow the same process for each locale you need to support.