从零开始构建一个网站
让我们来了解一下一个 blogdown 网站项目。
项目目录结构
一个 blogdown 应用项目由多个文件构成,共同构建网站。我们可以在下面的目录树中看到一些重要文件和文件夹:
1my-website/ 2├─ config/ 3│ ├─ _default/ 4│ │ ├─ languages.toml 5│ │ ├─ menus.en.toml 6│ │ ├─ params.toml 7├─ content/ 8│ ├─ english/ 9│ │ ├─ post/ 10│ │ │ ├─ post1.md 11│ │ ├─ _index.md 12│ │ ├─ about.md 13├─ static/ 14│ ├─ favicons/ 15│ ├─ images/ 16├─ themes/ 17│ ├─ anatole/ 18│ │ ├─ assets/ 19│ │ │ ├─ css/ 20│ │ │ ├─ js/ 21│ │ │ ├─ scss/ 22├─ config.yaml
-
config/目录和配置文件config.yaml用于设置网站的各项参数,包括标题、语言和作者信息。 -
网站的主要内容存放在
content/目录中。这些内容可以是以 Markdown(.md)或 R Markdown(.Rmd)格式编写的页面或文章。 -
static/目录包含网站使用的所有静态资源,如图片和图标。 -
themes/目录包含特定主题相关的文件。我们也可以在该目录中加载多个主题,并将其添加到config.yaml文件中。
我们已准备好了上述项目目录结构,以便于交互和查看。如果需要创建新项目,可以在“附录”中找到逐步操作指南。
更新基础 URL
更新基础 URL 对确保网站及其依赖项正确构建和部署至关重要。在 config.yaml 文件中,可将 baseURL 参数从 https://example.com 修改为 /。默认的 example.com 只是一个占位符,改为 / 后,网站即可部署在域名的根路径下。
进行基本编辑
运行本课末尾的代码后,我们会发现默认网站主页上仍显示占位文本,例如“我的博客”和“叫我简”。
以下是修改这些占位文本的步骤:
-
要修改主页上的“我的博客”,请进入
config/_default/languages.toml,更改title参数。 -
要修改主页上的“叫我简”,请进入
config/_default/params.toml,更改description参数。
1 [en] 2 title = "我是简·多伊" 3 author = "简·多伊" 4 #copyright = "2020-2021" 5 description = "叫我简" 6 profilePicture = "images/profile.jpg" 7 ...
让我们来构建一个网站!
以下提供了项目文件。点击“运行”按钮,查看网站的实际效果。尝试完成上述修改,然后再次点击“运行”按钮,查看更新后的输出结果。
注意:由于完整项目目录包含大量文件,我们并未展示全部内容。仅能查看并操作需要编辑的文件。
No configuration found for ID: ad66484ba6d3f483b7d421dff473d319914dc851c6b3561172960471a3bf446c
测验:blogdown 项目
以下测验旨在检验你对项目目录结构的理解程度。
Quiz
在 blogdown 项目中,Markdown 文章存放在哪个目录中?