Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 2 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,5 @@
## TinyBlog有什么特性
1. 完全静态,以至于没有任何生成程序
2. 支持Markdown常用语法
3. 支持Github用户添加评论

## 为什么要写 TinyBlog
有时候只想简单的写一篇文章,WordPress毫无疑问过于臃肿,Jekyll需要安装,而我想要一种更简单的更新博客方式,受到开源项目[Simple](https://github.com/isnowfy/simple)的启发,我用几个晚上的时间写了一个极简的静态博客.

每次写文章只有一个步骤,push写好的md文章到`./blog`目录下, that's all .

## TinyBlog 教程
1. 从[TinyBlog的Github主页](https://github.com/YangHanqing/tinyblog)fork一份到你的仓库,更改项目名称为`your_name.github.io`,几分钟后Github会自动为你开通[your_name.github.io](yanghanqing.github.io)的个人主页

2. 修改`about me.md`文件作为你的个人介绍,为了更快的加载速度,也可以选择写死在`index.html`中

3. 写好markdown文件后,保存到`./blog`目录下,依次执行下面的语句即可.如果你不熟悉Git如何使用,请参考Github提供的相关教程.

> git add .
> git commit -m "Update blog"
> git push

4. 如果修改了CNAME,记得core.js中把`user`改为自己的账户名,否则通过URL自动获取.

5. 分享文章给他人,可以通过在链接后加如下参数 `?title=文章名`

6. 建议新文章发布后,评论栏留空,并点击一下提交评论按钮,这样会用你自己的账户创建issue,以后如果comment有更新,不会打扰到第一个评论的人.

## 迭代方向
* 修复未知Bug(没有做测试,也没有考虑Github通讯不佳的情况)
* 支持响应式布局(第一次写前端,很手生)
* 基本上整个网站有交互就有AJAX,所以需要美化和增加相应的Loading提示
* 支持文章按发布时间排序(Github没有获取单独文件update时间的api,所有第一版没有处理,初步想法是通过 `001#TITLE`这样的命名规范来处理文章顺序)
* 做一个支持MD语法的Chrome扩展来更新博客,不过如果做了扩展,和Jekyll也没什么区别了,再议.
* 改成 ReactJS 驱动来练练手

## 评论功能
评论这个功能我是取巧了,利用Github API在项目issues下新建comment来存储,实现了原本需要第三方插件才能完成的功能.
## 许可
MIT


## ZhjGo博客

感谢YangHanqing 的代码,https://github.com/YangHanqing/tinyblog


File renamed without changes.
312 changes: 312 additions & 0 deletions blog/测试下.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,312 @@
# Markdown 语法和 MWeb 写作使用说明

## Markdown 的设计哲学

> Markdown 的目标是实现「易读易写」。
> 不过最需要强调的便是它的可读性。一份使用 Markdown 格式撰写的文件应该可以直接以纯文字发佈,并且看起来不会像是由许多标籤或是格式指令所构成。
> Markdown 的语法有个主要的目的:用来作为一种网路内容的*写作*用语言。

<!-- more -->



## 标题

Markdown 语法:

```
# 第一级标题 `<h1>`
## 第二级标题 `<h2>`
###### 第六级标题 `<h6>`
```

效果如下:

# 第一级标题 `<h1>`
## 第二级标题 `<h2>`
###### 第六级标题 `<h6>`



## 强调

Markdown 语法:

```
*这些文字会生成`<em>`*
_这些文字会生成`<u>`_

**这些文字会生成`<strong>`**
__这些文字会生成`<strong>`__
```

在 MWeb 中的快捷键为: `CMD + U`、`CMD + I`、`CMD + B`
效果如下:

*这些文字会生成`<em>`*
_这些文字会生成`<u>`_

**这些文字会生成`<strong>`**
__这些文字会生成`<strong>`__

## 换行

四个及以上空格加回车。

## 列表

### 无序列表

Markdown 语法:

```
* 项目一 无序列表 `* + 空格键`
* 项目二
* 项目二的子项目一 无序列表 `TAB + * + 空格键`
* 项目二的子项目二
```

效果如下:

* 项目一 无序列表 `* + 空格键`
* 项目二
* 项目二的子项目一 无序列表 `TAB + * + 空格键`
* 项目二的子项目二

### 有序列表

Markdown 语法:

```
1. 项目一 有序列表 `数字 + . + 空格键`
2. 项目二
3. 项目三
1. 项目三的子项目一 有序列表 `TAB + 数字 + . + 空格键`
2. 项目三的子项目二
```

效果如下:

1. 项目一 有序列表 `数字 + . + 空格键`
2. 项目二
3. 项目三
1. 项目三的子项目一 有序列表 `TAB + 数字 + . + 空格键`
2. 项目三的子项目二

### 任务列表(Task lists)

Markdown 语法:

```
- [ ] 任务一 未做任务 `- + 空格 + [ ]`
- [x] 任务二 已做任务 `- + 空格 + [x]`
```

效果如下:

- [ ] 任务一 未做任务 `- + 空格 + [ ]`
- [x] 任务二 已做任务 `- + 空格 + [x]`

## 图片

Markdown 语法:

```
![GitHub set up](https://assets-cdn.github.com/images/modules/logos_page/Octocat.png)
格式: ![Alt Text](url)
```


效果如下:

![GitHub set up](https://assets-cdn.github.com/images/modules/logos_page/Octocat.png)

## 链接

Markdown 语法:

```
email <example@example.com>
[GitHub](http://github.com)
自动生成连接 <http://www.github.com/>
```



Email 连接: <example@example.com>
[连接标题Github网站](http://github.com)
自动生成连接像: <http://www.github.com/> 这样

## 区块引用

Markdown 语法:

```
某某说:
> 第一行引用
> 第二行费用文字
```

效果如下:

某某说:
> 第一行引用
> 第二行费用文字

## 行内代码

Markdown 语法:

```
像这样即可:`<addr>` `code`
```


效果如下:

像这样即可:`<addr>` `code`

## 多行或者一段代码

Markdown 语法:

```js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}

}
```


效果如下:

```js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}

}
```

## 顺序图或流程图

Markdown 语法:

```sequence
张三->李四: 嘿,小四儿, 写博客了没?
Note right of 李四: 李四愣了一下,说:
李四-->张三: 忙得吐血,哪有时间写。
```

```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?

st->op->cond
cond(yes)->e
cond(no)->op
```

效果如下( `Preferences` - `Themes` - `Enable sequence & flow chart` 才会看到效果 ):

```sequence
张三->李四: 嘿,小四儿, 写博客了没?
Note right of 李四: 李四愣了一下,说:
李四-->张三: 忙得吐血,哪有时间写。
```

```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?

st->op->cond
cond(yes)->e
cond(no)->op
```

更多请参考:<http://bramp.github.io/js-sequence-diagrams/>, <http://adrai.github.io/flowchart.js/>

## 表格

Markdown 语法:

```
第一格表头 | 第二格表头
--------- | -------------
内容单元格 第一列第一格 | 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 | 内容单元格第二列第二格
```

效果如下:

第一格表头 | 第二格表头
--------- | -------------
内容单元格 第一列第一格 | 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 | 内容单元格第二列第二格


## 删除线

Markdown 语法:

加删除线像这样用: ~~删除这些~~

效果如下:

加删除线像这样用: ~~删除这些~~

## 分隔线

以下三种方式都可以生成分隔线:

***

*****

- - -

效果如下:

***

*****

- - -


## Math

Markdown 语法:


```
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
```

效果如下:


$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$



## TOC

Markdown 语法:

```
[TOC]
```

效果如下:

[TOC]


Loading