Markdown

我没有前端经验,但1天就搞定了开源项目主页

强颜欢笑 提交于 2020-10-16 08:44:26
前言 前段时间打算为自己的开源项目做一个主页,一方面有个好的门面能提升项目的关注度,一方面也能对项目所涉及的资源做一个整合。 其实原先项目已经有一个文档主页,比较简洁,大致长这样: 其实看起来也还可以是不? 这是用docsify做的,docsify是一款优秀的文档生成工具,使用起来比较简单,只需要写内容的markdown文件就可以了,支持markdown的大部分语法,并且自己也扩展了部分语法显示效果。 但是我觉得docsify虽然建文档还不错,但用来建项目主页就有点寒酸了。首先它的定位就是文档工具,其次主题样式不够丰富,页面的定制性也比较差,就这么一个套路。我对于静态建站工具有这么几点要求 主题丰富,美观简洁。毕竟项目首页是一个项目的门面,好看是很重要的。 搭建简单,尽可能的只让我关注内容部分,因为毕竟我对前端并不精通,不想为了建主页而去学一大堆前端知识。 首页需要层次分明,有那种大项目首页的既视感。 页面定制化强,不能千篇一律。 能够最大化整合资源,多级目录。 静态网站生成工具 我带着这些要求去比较了当下常见的静态站点生成工具。最终决定在Hexo,VuePress,Docusaurus这3个当中选。 仔细比较了功能点之后,最终我选择了Docusaurus,原因是....颜值好看。 当然,颜值是重要的一部分,其次的原因是,Hexo烂大街了,而且个人觉得不太适合做开源项目主页

Markdown简易教程

倾然丶 夕夏残阳落幕 提交于 2020-10-15 22:59:51
一、快捷键 功能 快捷键 加粗 Ctrl + B 斜体 Ctrl + I 引用 Ctrl + Q 插入链接 Ctrl + L 插入代码 Ctrl + K 插入图片 Ctrl + G 提升标题 Ctrl + H 有序列表 Ctrl + O 无序列表 Ctrl + U 横线 Ctrl + R 二、基本语法 1、标题 使用#号可表示 1-6 级标题,1级标题对应一个#号,2级标题对应两个#号,以此类推。 2、字体 2.1 加粗 要加粗的文字左右分别用**包起来。 **加粗** 1 2.2 斜体 要倾斜的文字左右分别用*号包起来。 *斜体* 1 2.3 斜体加粗 要倾斜和加粗的文字左右分别用***号包起来。 ***斜体加粗*** 1 2.4 删除线 要加删除线的文字左右分别用~~号包起来。 ~~删除线~~ 1 2.5 下划线 下划线可以通过 HTML 的 <u> 标签来实现。 <u>下划线</u> 1 2.6 脚注 脚注是对文本的补充说明。 格式:[^要注明的文本] 例:我买几个橘子去。你就在此地,不要走动。 [^1] [^1]:出自《背影》 1 2 3 3、分割线 用三个以上的*、-、_来建立一个分隔线,行内不能有其他东西。也可以在*或是-中间插入空格。 ******** -------- 1 2 4、列表 4.1 无序 无序列表使用星号*、+或是-作为列表标记。 * 第一项 * 第二项

为什么程序员应该写博客?用什么博客系统?

*爱你&永不变心* 提交于 2020-10-14 16:50:49
作者 谢恩铭,公众号「程序员联盟」(微信号:coderhub)。 转载请注明出处。 原文: http://www.jianshu.com/p/f7a970b08362 内容简介 前言 写博客的态度 写博客的好处 用什么博客系统 我的平台 1. 前言 作为程序员,我们敲代码的时候很轻快,键盘上噼里啪啦,「弹指间,樯橹灰飞烟灭」。但是,不少程序员不喜欢写东西。 当然,人都是有惰性的,要跨出这一步不容易。我开始得也有点晚,不过晚总比不开始好。 现在我很喜欢写博客,写博客带给我很多好处。比如有一点副业收入,有粉丝和自己的社群,认识更多大牛,写作能力提高,更喜欢思考,更喜欢阅读和学习,感觉充实,等等。 2. 写博客的态度 以前我觉得,都有那么多牛人写技术文章了,我这样的小辈看看就好,况且: 写了会不会没人看呢? 写了被人吐槽怎么办?(你说:我脸皮薄啊。有多薄?比 B-Box 还要薄啊) 关于写了有没有人看,我想让大家放一百个心。这个年代,只要你持续产出,基本就一定会有人看(因为中国人特别多),就怕你不产出。 当然了,我的每篇文章都要花不少时间来查证,以免误导读者。特别是错别字和语法,我会仔细检查。有时候读者评论说“你这里有个错别字”,我会立马更正,并留言谢谢他。 我觉得如果一篇博文有很多错别字和语法错误,基本上证明这个作者没有那么认真对待,要么他的语文水平实在有限。如果是小编的话,那是要被扣

时光.

爱⌒轻易说出口 提交于 2020-10-13 08:56:10
且视他人之疑目如盏盏鬼火,大胆地去走你的夜路. 新的一年,新的自己,也是时候,换一篇新的日记了 (其实换一篇的原因仅仅是为了用 markdown ) 旧的日记地址: 流年. 2020.08.24 中午听见下面练军歌了,不知道为啥不睡觉…… 然后,晚上下面练军歌,我直接服 练了整整一晚上,而且还是喊的,一般人能受得了? 学生明天嗓子就疼了,叫我我绝对不会再唱下去,唱也会很小声 我能听出来他们的疲惫. 两三个小时连着唱,这可是歌手开演唱会的时候才做的事儿啊! 更何况歌手是有发声技巧的,他们这么喊,听着心里都难受 这个老师啊,你自己能唱,就觉得别人能唱? 凭什么要用你的标准去要求别人? 想骂人了…… 下午一区63级学弟来了,为啥他们就训了6天= = 不知道为什么,现在特别喜欢下雨 听见雷声时的感受不是恐惧,而是欣喜 傻了吧唧的 你说巧不巧 2020.08.23 爷青回 2020.08.22 人啊 你不需要他的时候他偏偏一直出现在你身边 你需要他的时候他就没影了 2020.08.21 瞬间有了做题的动力!! 每天拍蚊子…… 2020.08.19 定的计划完不成,颓一整天不带停,写的博客没人看,没有动力不太行 每天的真实状态 下午喝水把水倒到了键盘上…… 去网上百度:没事百度,癌症起步。 用纸擦了擦,放到外面晒了晒,两个小时之后又插到电脑上,完全没有问题 好键盘,好键盘 2020.08.18

多图预警 | 我为博客园新增了十几个功能

被刻印的时光 ゝ 提交于 2020-10-12 08:34:56
前置 最近写了几篇随笔,大家都不看内容,看博客皮肤 😂,满足你们。以下所有功能都可作为一个插件使用,你可以将它迁移到你的博客,代码仓库地址在文末。或者使用 awescnb 将这些插件集成到你现有的博客园皮肤。若有错误,恳请指点一二,感激不尽。欢迎评论区交流。另外插件还在不断扩充。 基本配置 属性 描述 值类型 默认值 可选值 name 全局主题名称 String 'reacg' 'reacg' 'element' 'gshang' 'acg' color 全局主题色 String '#ffb3cc' 16 进制颜色值 avatar 头像图片链接 String 无 title 网站标题 String 你的博客名 favicon 网站图标链接 String 内置 headerBackground 头部背景,图片链接 String 内置 theme: { name: 'reacg', color: '#FFB3CC', title: '', avatar: '//pic.cnblogs.com/avatar/1501373/20200119190802.png', favicon: 'https://guangzan.gitee.io/imagehost/awescnb/favicon.png', headerBackground: 'https://guangzan.gitee.io