“笋尖”博客使用说明

准备工作

  1. 注册一个“七牛云”账号
  2. 最好能够完成实名认证,当然不完成也可以用,只是可用空间会比较少。
  3. 新建一个空间,名字随便起,其他的如图配置好。
  4. 下载用来同步博客的客户端,Windows下载

客户端配置

  1. 打开客户端,首先选择你需要同步的文章文件所在的文件夹
  2. AccessKey和SecretKey需要你在七牛云的这个页面

  3. 将这两个分别复制粘贴到AccessKey、SecretKey一栏
  4. 空间名就填写step3时创建的那个空间名
  5. 一切就绪后,点击保存。

网站配置

  1. 访问你的博客,会自动跳转到这个页面
  2. 其他都可以随便填,七牛云域名这里需要你到你刚刚创建的空间的那个页面

  3. 直接复制粘贴这个url即可,所有都填好后输入密码,点击“提交”。

  4. 准备工作完毕,可以开始使用了。

创建博客

  1. 点击创建博客按钮
  2. 弹出一个对话框,文件名必填,其他选填。
  3. 点击“创建”后会在博客文件夹根目录下创建一个文件名.md的文件,你可以直接用你的markdown编辑器打开写文章啦
  4. 注意,文章头部是客户端自动生成的头部信息,除了id不能随意更改之外,其他的信息可任意更改。了解更多头部信息详情
    头部信息的id很重要,任意修改或删除会造成文章评论、阅读量等等信息的丢失!
  5. “笋尖”博客暂时只支持后缀名为.md的文件,且文件内容为markdown格式。

迁移已有文章

如果你在目录下已经有了一些.md的文件,但这些文章没有“头部信息”,这时你可以点击客户端菜单栏的菜单,有一个“一键迁移”的按钮,它能自动为所有文章加上“头部信息”。

写文章

  1. 你的文章应当从头部信息的---分割线的下一行开始写起。
  2. 写作格式完全支持markdown。
  3. 文章(md文件)和资源文件(图片、视频等等)可以直接放到你博客文件夹的任意目录下。
  4. 引用资源文件可直接使用相对路径,如下图:
  5. 你可以归档你的文章,直接使用文件夹来做文件的分类,“笋尖”支持你嵌套任意多的文件夹。

同步文章

  1. 当你创建或修改了文章,想要发布时,可以直接点击“立即同步”按钮。
  2. 此时,你添加或修改的文章、资源文件全部都会同步到云端。
  3. 这时再访问你的博客,你会发现文章已经全部更新了。

个人简介页

  1. 在文件根目录新建_personal.md文件,它对应博客里的“个人”页。
  2. 你可以在这个文档里写入个人信息或者任何想对读者说的话,让大家更快更全面地了解你。

其他Tips

  1. (windows)客户端点击关闭按钮时会最小化到右下角的图标里,此时若想唤出主界面,只需双击图标即可。你也可以直接右击图标,直接点击菜单进行各种快捷的操作。
  2. 目前暂不支持自动同步,所以界面的按钮是灰的,不用理会它。
  3. 使用markdown语法里代码块的时候,你可以在三个“撇”后面加上你代码块内使用的语言,这样针对不同语言就会有语法高亮显示了。如下所示:

    写法:

    1
    2
    3
    import os
    for i in xrange(10):
    print i

    效果:

    1
    2
    3
    import os
    for i in xrange(10):
    print i
  4. 你在文章中,使用“#”、“##”来作为一级、二级标题。笋尖会自动根据它们做文章索引。

    点击博客右上角的按钮,可唤出索引列表,点击列表某一标题,即可快速定位到文章中的标题处。