基地官网文章上传的解决方案

解决方案

方法一

在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个`结尾

中间写你需要高亮的代码

高亮样式

screenshoot

缩进标准为 tab-size: 2

大标题

文段大标题使用 ## 标题名 使用

大标题样式

screenshoot

小标题

文段小标题使用 ### 标题名 使用

注意: 博客书签 只支持如上两种标题,不要写 # 一级标题 和 #### 四级或以下的标题

小标题样式

screenshoot

引用样式

如果需要引用,可以用一个 > ,并在这个> 下写需要引用的东西 ,可以换行,但是一个代码块有且只有一个>

引用样式

screenshoot

图片

图片点击可以放大

ul

使用* 符添加ul列表 注意*后面一定要有空格

样式:

ul

ol

使用1. 2. 3. 添加ol列表 注意. 后面一定要有空格!

样式:

ol

table

可以使用markdown 语法生成表格

样式:

table

Caveat

① 注意,代码与上下文之间必须有一行空行!!

② 以上所有xxx代指语言 如:javascript , xxx语言必须小写!!

温馨提示

  1. 所有基地成员都可以上传文章。
  2. 所有文章均为markdown格式。
  3. 所有文章里的图片,视频等必须是外链形式,也就是说它是保存在网络上的而不是保存在文件夹里。原因是因为github单个Repository不超过1G,单个文件不超过100M。这么做可以减少空间的占用。
  4. 如果想在文章里面展示demo推荐使用codepen。
  5. 建议学习使用markdown,网上有很多教程,熟练后可以控制文章在网上的展现格式。
  6. 建议学习使用github,网上有很多教程。了解它的协同工作流程。
  7. 建议本地电脑安装有Sublime Text3、markdownpad2、git客户端。
  8. 有任何问题可以随时问我。
- CATALOG -