目录

目录

我的主题日记

2024-10-02 10:59:41

1.front-matter自定义参数

注:与posts无关,只与page有关

{
/*这个表明page页面中该页面是该项目的第一文件
 *对于一个文件夹
 *--project
 * └-概述
 * |└day01.md
 * └-入门
 * |└day02.md
 * └--进阶
 * |└day03.md
 * └index.md
 * 其中index.md的front-matter中可以加上该参数
 * 加上该参数后project文件夹下除index.md的其他文件会按该文件路径结构排布为抽屉式导航栏
 * 并且点击各部分导航栏链接时不会重新遍历pages再次组织成导航栏而浪费资源
 * 也就是只有第一次进入project的page时会全部加载一遍
 * 
 * 2024-10-4 更新
 * 该参数已无任何作用，重新处理了page.ejs的显示逻辑，生成的抽屉式导航栏结构会保存在
 * site._page_catelog中，不管是直接访问还是从主站访问都不会重复加载导航栏
 * posts.ejs的逻辑同理保存变量为site._posts_catelog
 * site._page_catelog{
 *      _path_name: project_page/project_name,
 *      _children:[{
 *          _dir_name:      ,//如果是目录就是目录名，是文件就是文件名 例如
 *                              'abc/ccc.md'或者'abc/ccd/fff.md'
 *                              先将它们按'/'分离,搜索到abc这里就是abc,搜索到ccc.md这里就是ccc.md
 *          _url_path:      ,//只有检索到文件才会有,page.path
 *          _page_title:    ,//同上page.title
 *          _children:[...]  //多个该结构
 *      },...]
 * }
 * 
 * site._posts_catelog{
 *      category_name: category.name,
 *      _children:[{
 *          _name:          ,//同上结构的_dir_name
 *          _path:          ,//post.path
 *          _children:[...] ,//多个该结构
 *      },...]
 * }
 */
 config:true,
 
 /*该参数表明该页需要用到的布局 XX.ejs会被page.ejs包含(&lt- include(include_layout) &gt)
  *不写该参数会填入默认布局page_content_main.ejs
  */
 include_layout: ../widget/../XX.ejs
}

2.编写markdown的一些注意事项

注:只针对hjdd主题

1.h1标题不要使用#

使用#的标题在生成html的时候会在标题下面生成a元素并与该标题链接 主题中对内容的其他链接元素使用css美化时也会应用于该标题生成的链接

2.front-matter的categories只允许写一种

/*该主题的‘学习分类’栏会根据文章的categries的数据进行分类,文件夹直观图
    --source
     └-category1
     |└-directory1
     ||└content.md   //categories: -category1
     |└content1.md   //categories: -category1
     └-category2
      └content.md   //categories: -category2
      └content1.md   //categories: -category2
*/

3.项目页结构

/*文件夹直观图
    --project_page
     └-project1  //项目文件夹下除了index.md以及文件夹外不允许有任何其它文件
     |└-directory1 //可以存放其他文件夹或.md
     ||└...
     |└-directory2 
     |└index.md     //必须,包含title:项目名 date:项目日期 
     └-project1
     |└index.md   //必须
     └index.md		//必须
*/

3.编写markdown的细节

1.<!–more–>之前的是摘要page.excerpt,之后的是正文page.more

文章简介