一看就会的保姆级教程,10分钟搭建个人博客(二)

简介: 接上文。

(6)themeConfig


该属性表示的是主题的配置信息


这里东西有点多,我们慢慢来讲


1. nav


该属性表示导航栏的配置信息


默认生成的 nav 值如下:


"nav": [
      {   // 第一个导航按钮
        "text": "Home",   //  按钮名称为 Home
        "link": "/",      //  对应的跳转链接为  /
        "icon": "reco-home"  // 按钮的前置图标为 reco-home
      },
      {   // 第二个导航按钮
        "text": "TimeLine",     //  按钮名称为 TimeLine
        "link": "/timeline/",  //  对应的跳转链接为  /timeline/
        "icon": "reco-date"   // 按钮的前置图标为 reco-date
      },
      {   // 第三个导航按钮
        "text": "Docs",    //  按钮名称为 Docs
        "icon": "reco-message",  // 按钮的前置图标为 reco-message
        "items": [   // 该按钮的子菜单
          {   // 子菜单中的第一个导航按钮
            "text": "vuepress-reco",
            "link": "/docs/theme-reco/"
          }
        ]
      },
      {  // 第四个导航按钮 
        "text": "Contact",   //  按钮名称为 Contact
        "icon": "reco-message",  // 按钮的前置图标为 reco-message
        "items": [  // 该按钮的子菜单
          {    // 子菜单中的第一个导航按钮
            "text": "GitHub",
            "link": "https://github.com/recoluan",
            "icon": "reco-github"
          }
        ]
      }
]


详细的注释我都已经写在上面了


2. sidebar


该属性表示的是侧边栏的导航信息


默认生成的是:


"sidebar": {
      "/docs/theme-reco/": [
        "",    // 空字符串对应的是 README.md
        "theme",  // 对应 theme.md
        "plugin",  // 对应plugin.md
        "api"    // 对应api.md
      ]
},


该配置信息表示的是当路径为 /docs/theme-reco/ 时,侧边栏会自动找路径 ./docs/theme-reco/ 下的 README.mdtheme.mdplugin.mdapi.md 文件进行识别生成侧边栏,如图所示:


9bfeb3f60be61e20f8ce3ca8fc30ef6a.jpg


侧边栏的文字其实是识别了 md 文件中的 title ,例如 theme.md 文件对应的名称就是 title 的值


---
title: theme
date: 2020-05-27
---
This is theme.


这是一种写法,但其实还有另一种更为复杂一点的写法,我们来看一下


"sidebar": {
 "/docs/theme-reco/": [
        {
            title: '一些文件',    // 标题信息
            collapsable: true,   // 是否可折叠
            children: [        // 该块内容对应的所有链接
                "",    
                "theme",  
                "plugin", 
                "api"    
            ]
        }
    ]
}


这样的实现效果其实和刚才是差不多的,区别的话可以看下图来对比一下:


f66d616575acab22f2a6302e1ffdd960.jpg


3. type


该属性表示的是当前项目的类型


默认的是 blog ,也就是我们现在看到的样式,其实还有别的值可以设定,例如 docs ,其对应的就是比较简约化的文档样式了,当然了这些都是脚手架帮我们处理好了的


4. blogConfig


该属性表示的是导航栏的配置信息,其是 reco 主题设置的


442fda3c6af499568555f54a70d01a5d.png


不知你有没有发现,刚刚设置 nav 导航栏信息的时候,一共有 4 个导航栏按钮,但实际呢?


实际情况却有 6 个,那么多出来的两个是哪里来的呢?其实就是 blogConfig 中设置的


"blogConfig": {
      "category": {
        "location": 2,     // 在导航栏中的位置在第二个
        "text": "Category"
      },
      "tag": {
        "location": 3,   // 在导航栏中的位置在第三个
        "text": "Tag"
      }
},


这两个都是内置的设定好了的,所以只要按这样配置好就可以了,不过我感觉是不太需要,大家可以自己抉择


5. friendLink


该属性是用于设置友链的


具体在网站中的位置如下图所示:


9ec605ad9a1b83d3b7c33c350a2e398c.png


配置的话也比较简单,模仿默认的配置去做就可以了:


"friendLink": [
      {
        "title": "午后南杂",
        "desc": "Enjoy when you can, and endure when you must.",
        "email": "1156743527@qq.com",
        "link": "https://www.recoluan.com"
      },
      {
        "title": "vuepress-theme-reco",
        "desc": "A simple and beautiful vuepress Blog & Doc theme.",
        "avatar": "https://vuepress-theme-reco.recoluan.com/icon_vuepress_reco.png",
        "link": "https://vuepress-theme-reco.recoluan.com"
      }
],


6. logo


该属性表示的是导航栏最左侧的 logo 图片,如下图所示


1ce3513235f417a1272a5f942c96ddc1.png


在写该值时的根路径是 public ,即 /logo.png 表示的就是 public 下的 logo.png


7. search


该属性表示是否有搜索功能


8. searchMaxSuggestions


该属性官网也没做过多说明,所以我也不知道有什么用,暂且可以不用管


9. lastUpdated


该属性表示每篇文章底部显示的 "最后一次更新时间" 的文案


如下图所示:


cc60b9b7216e0df783dc83d889d0b841.png


10. author


该属性表示作者的名称,在每一篇文章的作者署名中都会沿用该名称


11. authorAvatar


该属性表示作者的头像,与 logo 一样的路径规则,头像显示位置如下图所示:


cd9a5a00b5d04109c65f57a2971233ea.png


12. record && recordLink && cyberSecurityRecord && cyberSecurityLink


record: ICP备案号


recordLink: ICP 备案指向的链接


cyberSecurityRecord: 公安部备案文案


cyberSecurityLink: 公安部备案指向链接


如果项目不是部署在个人服务器上的话,这四个属性可以忽略不管


13. startYear


该属性表示博客的开始时间(只需要写年份就可以了),在网站上的展示如图所示:


40bad3a5ce342a88a8e9ad7c536e8dff.png


左侧是我们填写的时间,右侧是根据当前时间自动生成的年份


(7) markdown


该属性里存储着一些对于 markdown 解析的配置


例如脚手架自动生成的 lineNumbers 表示的就是代码块显示行号


其实还有其它很多的 markdown 配置,详细参考 vuepress官方(opens new window)[4]

相关文章
|
监控 Ubuntu 算法
玩转Ubuntu基础教程
玩转Ubuntu基础教程
395 0
|
存储 小程序 JavaScript
云开发(微信-小程序)笔记(五)----云函数,就这(上)
云开发(微信-小程序)笔记(五)----云函数,就这(上)
1656 0
|
网络协议 Linux Android开发
告别无法访问的github(附解决方案)
最近一行在使用github的时候又登不上去了,挂着NPV都没用 据说是某些不可描述的有关组织机构对该网站的DNS污染或者随机丢包造成的
25292 5
告别无法访问的github(附解决方案)
|
存储 机器学习/深度学习 人工智能
告别信息焦虑,用这个国产AI工具做知识管理,大脑终于解放了
文章介绍了纳米AI知识库作为“第二大脑”的强大功能。它能高效管理海量信息,支持54种文件格式上传,自动提取关键数据并打标签,轻松整合工作与生活中的碎片化信息。通过场景测试显示,在工作和生活中,纳米AI可快速生成报告、提供精准数据,极大提升效率。其共享机制还促进了团队协作,释放了创造力,让用户从琐碎事务中解脱,专注于深度思考与创新。
|
JavaScript 中间件 测试技术
FastAPI全面指南:从入门到企业级应用实战
FastAPI正迅速成为Python Web开发领域的明星框架。它以高性能、高效率和现代化特性著称,性能媲美Go/Node.js,支持异步编程并内置自动化文档系统。本文全面解析FastAPI核心功能,包括类型安全路由、Pydantic数据验证、异步支持等,并通过实战案例展示其在RESTful API开发、微服务架构、实时数据处理及机器学习模型部署中的应用。同时,文章提供数据库集成、中间件配置和测试策略等最佳实践,解决常见问题并展望未来技术发展方向。掌握FastAPI,助你构建高效现代化Web应用。
2321 1
|
10月前
|
存储 Linux 虚拟化
AlmaLinux 10.1 发布 - RHEL 二进制兼容免费发行版
AlmaLinux 10.1 发布 - RHEL 二进制兼容免费发行版
773 1
AlmaLinux 10.1 发布 - RHEL 二进制兼容免费发行版
|
6月前
|
网络协议 安全 数据建模
2026阿里云免费SSL证书全攻略:申请流程、下载教程及常见问题解答
阿里云免费SSL证书是Digicert颁发的DV单域名证书,每人每年可领20张,有效期3个月,适用于测试与个人非生产环境。支持一键申请、手动DNS/文件/自动授权验证,提供Nginx/Tomcat/Apache等多格式证书下载,零费用快速启用HTTPS。
|
开发工具 开发者
【HarmonyOS 5】如何开启DevEco Studio热更新调试应用模式
【HarmonyOS 5】如何开启DevEco Studio热更新调试应用模式
740 0
|
传感器 人工智能 机器人
具身智能9大开源工具全景解析:人形机器人开发必备指南
本文旨在对具身智能、人形机器人、协作机器人、AI机器人、端到端AI系统、AI Agent、AI Agentic、空间智能或世界模型等前沿领域中具有重要影响力的开源软件产品或工具进行深入分析,重点聚焦于支持这些先进AI能力实现的工具、平台和框架。
4034 8
|
传感器 网络协议 物联网
嵌入式开发中的常用实时操作系统(RTOS)介绍
选择合适的RTOS是嵌入式开发中的关键步骤,不同的RTOS具有各自的优势和适用场景。开发者需要根据项目需求综合考虑硬件平台、实时性要求、开发资源和支持等因素,选择最合适的RTOS系统。例如,如果需要开源和灵活的解决方案,可以选择Zephyr或RT-Thread;如果需要高性能和商业支持,可以选择VxWorks或ThreadX。希望本文能帮助您更好地了解各类RTOS,并为您的嵌入式开发项目提供参考。
1918 1

热门文章

最新文章