跳到主要内容

2 篇博文 含有标签「Docusaurus」

查看所有标签

· 阅读需 2 分钟
刘泽桦

需求

我是使用Docusaurus建立的个人站点,在写文档是总是要在开头配置作者、日期等等,用过Docusaurus的都应该知道。

因为每次新建一个md文档都需要重新配置,很麻烦,于是我就想能不能新建一个用户代码片段(vscode的一个功能),每次我只需要敲几个字符,按回车就能得到一个模板,以至于每次写markdown的时候都不需要从零开始写配置。

vscode代码片段

经过一番折腾,中间还出现了问题,网上找了一些教程才解决。于是有了下面的代码片段:

{
"Print to ---doc":{
"prefix":"---doc",
"scope": "markdown",
"body":[
"---",
"authors: Jeffery",
"title: ",
"date: 2023-",
"description: ",
"keywords: []",
"tags: []",
"---",
],
"description":"Docusaurusb front matter"
}
}

注:vscode用户代码片段:左下角管理--用户代码片段--新建

markdown语言的配置

一开始我没有在vscode中配置markdown,所以我的用户代码片段没有生效。

上网查资料得知需要如下配置:

  1. vscode“设置”页面中点击右上角的json

  2. 输入下面的内容(主要是 "editor.quickSuggestions": true,)

    "[markdown]": {
    "editor.renderWhitespace": "all",
    "editor.quickSuggestions": true,
    "editor.acceptSuggestionOnEnter": "on"
    }

效果

完成以上的配置之后,我在用vscode写markdown的时候,只需要敲 ---doc然后回车就能得到我自定义的模板啦。

· 阅读需 4 分钟
刘泽桦

2023年4月23日,个人网站的第一篇博客。写点什么呢?聊聊关于建站的一些东西吧。

为什么要建站

作业

没开玩笑,真的是作业。网络营销要弄一个SEO的作业,提高自己名字在搜索引擎中的排名。

其他

可能就是大多数bloger建站的原因吧。拥有属于自己的网站,在我认为是挺酷的,还有就是写博客的好处吧:巩固知识、提高表达能力...

我是如何建站的

网站生成器

首先是网站类型,肯定是选静态网站,静态网站本身就是把一堆网站文件放在服务器让别人访问,对SEO友好,也不用自己搞后端的东西。然后就是选择网站生成工具,而不是自己从0到1建网站。有现成的东西,为什么不用呢?常见的静态网站生成器有:WordPress、vuepress、Hugo、Docusaurus等。选择Docusaurus可能因为它比较小众吧,还有就是这小恐龙挺可爱的。

Docusaurus

使用体验:只需要亿点点配置就能搭建网站(如果要配置个性化的主题、搜索、评论等功能确实要配置很多东西)

样式与页面

样式和页面参考借鉴自7Wates Wiki,然后把首页针对移动端做了一些优化适配,使得移动端的布局更舒服,特别是把我的小狗也完整展示出来(原来是不行的)。

服务器

服务器用的是阿里的,飞天加速计划的ECS服务器。好是很好,就是是个白板服务器,一点东西都没有,环境都需要自己配置。通过宝塔面板安装一个阿帕奇服务器软件,让它真正成为能对外提供内容的服务器。

另外呢,要注册域名,要进行备案。第一次备案,提交各种资料,还要签一份保证书,所有流程我大概用了一个星期吧,还算顺利。就是阿里云初审时,打了两次电话过来让我改了一些资料。

部署

本来打算用github的Action来自动部署的,但是我搞了很久没搞明白。一开始是报各种错误,解决了报错之后,发现没能把我的网站文件传送到我服务器上的网站根目录,不知道哪里错了。索性用笨方法:build命令一敲,把生成的文件直接通过远程桌面复制到网站根目录。