Publish the Site
{.docImage}
Next, we'll learn how to publish the site to the WWW for everyone to browse! 处于教学目的,我们将使用 Github pages 对我们的网站进行托管。 但是你可以选择使用任何其他的静态网页托管服务,例如Netlify、Amazon S3等。
Put the Site Online
先关闭你本地的服务Cmd+C 或 Ctrl+C (由你使用的操作系统决定)。
在 website/siteConfig.js
在填写以下字段。
const siteConfig = {
...
url: 'https://USERNAME.github.io', // Replace USERNAME with your GitHub username.
baseUrl: '/docusaurus-tutorial/', // The name of your GitHub project.
projectName: 'docusaurus-tutorial', // The name of your GitHub project. Same as above.
organizationName: 'USERNAME' // Your GitHub username.
...
}
在
website
目录下,运行npm run build
或yarn build
命令。 这将在website
目录下生成一个build
文件夹, 其中包含website
目录下所有文档和其他页面中所含的.html
文件。 保证build
目录生成后才进行下一步骤。用您的GitHub 用户名替换
<GIT_USER>
并运行以下命令。$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages
内置代码将被推送到你的 Github 仓库的 gh-pages
分支下。
- 转到
https://USERNAME.github.io/docusaurus-tutorial/
并查看您的站点!
Note that when you run
npm run start
again, thebaseUrl
will now be part of the path.