解决方案
方法一
在Github上fork基地官网项目,然后通过git工具clone到自己的本地,之后你可以在本地的_posts文件夹里添加之前你已写好的文章(tech为技术类,Other为其他类),然后通过git工具上传。此时你的github里fork的基地项目就添加了新文章,但是注意基地官网并不会改变。你需要点击New pull request提交申请,然后我会审核其中的内容规范,审核通过后我会确认修改,那么一篇新文章就会出现在官网里面。
方法二
可以把你的文章、英文名直接发给我,我来帮你解决之后的事情。要求: 内容需要使用标准markdown格式,详细标准可以参考已发布文章的markdown文件。
撰写博文
这方面的说明在README里有所说明,方便起见我把它拿到了这里。
如需撰写博文,首先和我(Neo)提交一个固定的作者名,我将作者名与css高亮文件匹配一下,就能开始撰写博文了
每次编写博文之前,需要填写一些简单文章信息
—
layout: post
title: HelloWorld
author: someone
tagpic: helloworld.jpg
description: 用心铸造卓越Offer
category: other
—
layout : 命令博文基于 post 布局,将写好的文章嵌入post.html 中
title : 文章标题
author : 作者名称(作者姓名开头大写)
tagpic : 文章配图名(包含后缀名称)
description : 关于文章的简单描述(最好简单详细 20到400之间不等)
category : 文章类型(如不清楚分类,可缺省为other类)
以上都是必须填写
文章配图最好将图片裁切成 280 * 250(设置了自动调节),裁切好的图片添加到/assets/img/index/post-list-imgs
文件夹
类型名称一定要统一且正确(关系到css类名匹配)
例如:
css
html
js
other
等等
如果有需要添加新的文章类型,直接来告诉我就行。
博文撰写就比较自由了,基于markdown 语法(不熟悉可以去百度了解下,很简单)
如果懒得学,直接打文字也行了,编码为__utf-8__
博文样式
代码高亮
如果我们需要使用代码高亮,可以使用markdown语法
以3个` 加 语言类型(如JavaScript)开头
再以3个`结尾
中间写你需要高亮的代码
高亮样式
缩进标准为 tab-size: 2
大标题
文段大标题使用 ## 标题名
使用
大标题样式
小标题
文段小标题使用 ### 标题名
使用
注意: 博客书签 只支持如上两种标题,不要写 # 一级标题 和 #### 四级或以下的标题
小标题样式
引用样式
如果需要引用,可以用一个 > ,并在这个> 下写需要引用的东西 ,可以换行,但是一个代码块有且只有一个>
引用样式
图片
图片点击可以放大
ul
使用*
符添加ul列表 注意*
后面一定要有空格
样式:
ol
使用1. 2. 3.
添加ol列表 注意.
后面一定要有空格!
样式:
table
可以使用markdown 语法生成表格
样式:
Caveat
① 注意,代码与上下文之间必须有一行空行!!
② 以上所有xxx代指语言 如:javascript , xxx语言必须小写!!
温馨提示
- 所有基地成员都可以上传文章。
- 所有文章均为markdown格式。
- 所有文章里的图片,视频等必须是外链形式,也就是说它是保存在网络上的而不是保存在文件夹里。原因是因为github单个Repository不超过1G,单个文件不超过100M。这么做可以减少空间的占用。
- 如果想在文章里面展示demo推荐使用codepen。
- 建议学习使用markdown,网上有很多教程,熟练后可以控制文章在网上的展现格式。
- 建议学习使用github,网上有很多教程。了解它的协同工作流程。
- 建议本地电脑安装有Sublime Text3、markdownpad2、git客户端。
- 有任何问题可以随时问我。