Skip to content

Commit ba3cc7b

Browse files
pftommrcfps
authored andcommitted
Update pictures and contact (#18)
* Update pictures and contact * Fix old docs issue
1 parent 1c9058f commit ba3cc7b

File tree

8 files changed

+19
-7
lines changed

8 files changed

+19
-7
lines changed

assets/s1.png

-34.4 KB
Loading

assets/s2.png

-135 KB
Loading

assets/s3.png

-55.8 KB
Loading

assets/s4.png

-66.5 KB
Loading

assets/s5.png

-26.6 KB
Loading

guide/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,8 @@
5353
图雀起源于传统的技术博客,但是却致力于解决一些根本性的问题:
5454

5555
- 传统博文的书写具有很大的随意性,导致文章质量差异很大,而图雀试图用一种统一的模式去书写教程(查看[开始书写教程](./start-writing.md))——即基于一个真实的 Git 仓库的提交记录构成教程,确保每一篇教程的可实践性
56-
- 优质的技术博客散落在互联网的各个角落,很难“一网打尽”,而图雀试图提供一个汇聚优质博文和作者的平台,让学习者不必再苦苦寻找
57-
- 传统博客的互动非常有限(一般都只有文后评论),而图雀试图提供一个方便且强大的社区功能,让作者和读者的沟通交流更加方便
56+
- 优质的技术博客散落在互联网的各个角落,很难“一网打尽”,[图雀试图](https://tuture.co/)提供一个汇聚优质博文和作者的平台,让学习者不必再苦苦寻找
57+
- 传统博客的互动非常有限(一般都只有文后评论),而图雀试图提供一个方便且强大的社区功能:1)每篇教程都会标明作者和其撰写教程的 Github 仓管,使得读者可以以 [Github Issue](https://github.com/tuture-dev/comments/issues) 的方式和作者直接交流改进教程内容;2)我们同时开通了 [Gitter](https://gitter.im/tuture-dev/tuture) 交流频道,使得作者和读者可以更加实时的交流想法,沉淀知识
5858

5959
## 写作体验的革命
6060

guide/sharing.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -30,9 +30,10 @@ $ git submodule add <repo_git_url> tutorials/<repo_name>
3030

3131
```bash
3232
$ npm install
33-
$ npm run buildTutorials
33+
$ npm run build:tutorials
3434
$ npm start
3535
```
36+
3637
:::
3738

3839
4. 提交修改并上传:
@@ -63,12 +64,12 @@ $ tuture build
6364

6465
### 涉及有图片资源的情形
6566

66-
如果您的教程中有图片资源,图雀会将默认的图片文件夹(即 tuture-assets)整个复制到构建的 Markdown 文档同一目录下。如果您想要自定义的路径前缀,build 命令提供了一个参数 `--assetsPath` 用于替换所有图片资源的路径前缀,并且所有图片会放入到
67+
如果您的教程中有图片资源,图雀会将默认的图片文件夹(即 tuture-assets)整个复制到构建的 Markdown 文档同一目录下。如果您想要自定义的路径前缀,build 命令提供了一个参数 `--assetsPath` 用于替换所有图片资源的路径前缀,并且所有图片会放入到这个路径里面
6768

6869
例如,原先教程中图片的 Markdown 代码可能是 `![](tuture-assets/img.png),那么通过运行以下命令:
6970

7071
```bash
7172
$ tuture build --assetsPath=images
7273
```
7374

74-
对应的图片代码就会替换成 `![](images/img.png)`
75+
对应的图片代码就会替换成 `![](images/img.png)`

guide/start-writing.md

+13-2
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,10 @@ Windows 用户请在 Git 附带的 **Git Bash** 中运行所有命令。
3131
```bash
3232
$ tuture init
3333
? Tutorial Name 用 HTML 和 CSS 写简单的静态页面
34+
? Description
3435
? Topics HTML,CSS
36+
? Categories
37+
info Inferred github repository: https://github.com/pftom/my-awesome-tutorial. Feel free to revise or delete it.
3538
info .gitignore file created.
3639
info Git post-commit hook added.
3740
success Tuture tutorial has been initialized!
@@ -56,7 +59,10 @@ success Tuture tutorial has been initialized!
5659
- `.gitignore`,这个文件大家都很熟悉了。Tuture 自动添加了忽略 `.tuture` 目录的规则,这里我们再添加一些 Node 项目的规则:
5760

5861
```
62+
# Tuture-related files
63+
5964
.tuture
65+
tuture-build
6066
node_modules
6167
```
6268

@@ -66,12 +72,17 @@ success Tuture tutorial has been initialized!
6672

6773
```yaml
6874
name: 用 HTML 和 CSS 写简单的静态页面
75+
description: ''
6976
topics:
7077
- HTML
7178
- CSS
79+
created: 2019-12-14T08:10:45.855Z
80+
updated: 2019-12-14T08:10:45.855Z
7281
steps: []
82+
id: 29cb98ae3ed81bdcb988968cd4f79f8f
83+
github: "https://github.com/pftom/my-awesome-tutorial"
7384
```
74-
85+
7586
::: tip 提示
7687
参考 [tuture.yml 详细说明](/reference/tuture-yml-spec.md)以了解所有字段的含义。如果你对 YAML 语法不太熟悉也没有关系,因为实际写教程的时候我们基本上不需要编辑此文件。
7788
:::
@@ -179,7 +190,7 @@ $ git commit -m "添加 CSS 样式表"
179190

180191
![](../assets/s4.png)
181192

182-
点击 Markdown 编辑器的预览按钮,就能看到我们刚才插入的图片了
193+
可以看到 Markdown 编辑器右边的预览展示了我们插入的图片
183194

184195
![](../assets/s5.png)
185196

0 commit comments

Comments
 (0)