二、网站内容管理
笔记作者:BrickLoo
内容摘要:本文记录了从搭建好基础样例页面并能正常访问后,一直到能够管理个人网站中的文章内容。本文仅包含博客文档创建和管理等操作,最后的效果是能在个人网站放入自己的文章,尚未包含样式的调整部分。
网站内容管理基本介绍
(不确定其他主题是不是这样子,但是在我使用的 Hextra 主题下,)网站的内容都以 md
格式放置在 content
目录下。参考 Hextra 主题官方模板,content
目录中的内容遵循以下规则:
- 其中的内容会根据文件地址被自动赋予链接,所以可以通过文件夹构成页面中的层级。链接会忽略特殊符号和
.md
后缀,并用-
填充空格。为了分享链接时的美观性,建议使用英文的文件名和文件夹名,或者在文档中显式地为那个页面指定 url(见后文); - 对于层级结构,如果希望将“文件夹”作为一个页面,用作“目录/首页/封面”等功能,只需要在那个文件夹下创建名为
_index.md
的文件;
文章基本模板
以前一篇文章为例,个人习惯使用以下模板来进行页面的创建:
---
date: '2024-01-02'
lastmod: '2024-04-22'
title: '一、主题配置和部署'
prev: '/docs/个人网站搭建'
url: '/docs/build-your-site/1'
next: '/docs/个人网站搭建/二、网站内容管理'
weight: '1'
---
笔记作者:BrickLoo
## 正文大标题
开始写正文……
其中,
title
属性起到了md
文件中# 一级标题
的作用,个人习惯直接使用文件名;因此,与此对应的是,后文中最大的标题需要从##
开始,否则主题样式渲染的结果会看起来比较奇怪;prev
和next
属性用来管理页面尾部的上下页跳转按钮,属性内容是以content
目录为根目录的文件绝对路径,个人习惯忽略.md
后缀;url
属性用于指定页面的 url;因为我的文件和文件夹选择使用中文进行命名,因此另外使用这个属性管理页面 url,提高美观度;weight
属性用于控制页面的排序,数值越大排得越下/越后。同文件夹下的md
文件会根据weight
自动填入prev
和next
属性;但是_index.md
文件中的这个属性是用于上一个层级的排序,因此需要自己按需设置prev
和next
属性;- 属性的顺序并无硬性要求,以上顺序只是个人习惯;