简易文档

文档是良好组织的富文本信息，能够携带大量有意义的信息。

现代科技让文档的排版和传播变得异常简单。

简易文档
- 文档形成
- 文档展示

文档形成

比如想要展示《悲惨世界》全部歌曲的歌词，那么只需要找到合适的网站，之后通过不复杂的代码就可以实现数据解析并自动形成 Markdown 文档。

url = 'https://www.fournoas.com/posts/Les-Mis%C3%A9rables-lyrics/'
resp = requests.get(url=url)
soup = bs(resp.content)
found = soup.find_all(['h2', 'h3', 'p'])

lines = [
    '''
# Les Miserables

// TOC

    '''
]

for e in tqdm(found, 'Generate MD'):
    if e.name == 'h2':
        lines.append('## ' + e.text)
        continue

    if e.name == 'h3':
        lines.append('\n---\n')
        lines.append('### ' + e.text)
        continue

    for ee in e:
        if ee.name == 'strong':
            lines.append('**' + ee.text + '**')
            continue

        lines.append(ee.text)

    # lines.append(e.text)

with open('readme.md', 'w',encoding='utf-8') as f:
    f.write('\n'.join(lines))

Markdown 文档

文档展示

接下来，将文档以代码仓库的方式上传到 Github，

https://github.com/listenzcc/Les-Miserables-Songs

再给它指令一个合适的 Page 功能并指定一个 Theme 就可以实现在线文档展示

Les Miserables

Theme setup

Online document