Skip to content

helijia-web/micro_conf

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 

Repository files navigation

点此访问

这里贴的是河狸家 Web 前端团队日常轻分享的资料。格式如下:


第 x 期 《主题》by 花名

参考:


「轻分享」旨在分享一些简短的知识点,题材不限。可以是新的技术发展方向,新的工具,新的框架,某个工具的使用方法,某个小的技术规范,某些历史文化知识……等等,控制在每个分享 5 分钟左右,分享+讨论的时间不超过 30 分钟。分享后提供 futher reading 资源链接,供大家继续探索即可。

一些原则

开放的心态

知识点可能很小,可能和工作或者没有关系。对这些不同的知识、思想可以接纳,或者挑战,甚至从反面去思考,都会对我们的认知有影响,让我们成为更好的自己。所以不要一开始就界定一个知识是「无用」的,然后选择忽略。

简短

最长不能超过 30 分钟(包含讨论)。

FAQ

#1589F0 Q: 这是什么??

A: 轻分享,是我们准备尝试的轻分享。

#1589F0 Q: 时间多长??每天都有吗??

A: 时间为每周一至周四的晚餐时间 (约18:45-19:00,等晚餐到开始)。周五没有分享。

#1589F0 Q: 我分享的东西,可能大家都知道了??

A: 不要担心这个问题,已经知道的知识,重新分享一下也是能学到新的东西,能锻炼自己的表达能力。另外,大家在一天的工作之后,坐在一起互相交流一下,也是一件惬意的事情。

#1589F0 Q: 我不知道有什么可以分享的,怎么办??

A: 平常多阅读,多记录。按现在的安排,每人每两周轮到一次,有足够的时间准备 5 分钟的技术小分享的。

另外分享的主题也不限于前端技术,只要你觉得对大家有帮助的都可以。

推荐一些灵感来源:

#1589F0 Q: 分享者要做些什么??

A: 1. 准备分享内容; 2. 邀请大家; 3. 主持分享 & 讨论; 4. 将分享资料和素材链接贴到固定位置。

#1589F0 Q: 分享的顺序是怎样的??

A: 以花名拼音排序:

  • (d)大鱼
  • (d)地念
  • (d)杜松
  • (h)花间
  • (l)临川
  • (l)落葵
  • (s)水华
  • (s)水凝
  • (s)水鸢
  • (w)五柳
  • (x)新雨

如果分享者当天请假,往下顺推。


排版建议

1. 用 ` 优化 inline code

- 标题是 <h2><h3>
+ 标题是 `<h2></h3>`

2. 用 ```优化多行 code

代码是阅读者最最最最关心的,理论说得再漂亮,最终也要拿代码来检验。无论如何,代码都值得更好的呈现。

3. 善用 ##, ###, #### 突出标题

起提纲挈领的作用,就像这篇文档的效果。 提纲有助于读者快速浏览到想要的内容。

4. 善用列表

用列表可以使内容更整齐,更有韵律。

  • 有序列表(1. 2. 3.)
  • 无序列表 (*, -)

5. 数字或英文,和中文之间有空格

- LAB色彩空间
+ LAB 色彩空间

- 《第100期》
+ 《第 100 期》

代码需要呼吸,文章也如此。

6. 超链接优化

如果不需要强调链接的地址,或者说链接 url 没有特别的含义,可以将链接隐藏。这样阅读起来噪音更少,内容就会更突出。

一些优化对比

before after
image image
image image
image image

tip 1

在写的时候,随时可以点下面的帮助查看 Markdown 语法: image

tip 2

持续修改:

  • 减少多余的噪音文字,直到足够简洁,少到不能再少为止。
  • 感受一下,阅读很流畅吗?

tip 3

可以看看这篇文档的 Markdown 源码哦。