写一本Flask入门教程

第一次萌生出这个念头是在2016年,刚开始写知乎专栏《Hello, Flask!》的时候。写了几篇文章后,原来计划的系统性的教程就变成了一堆零散主题的文章。一年后,又有过一次写教程的念头,那是在《用Flask实现豆瓣相册(一)》;只不过,刚刚完成第一篇,就开始写《Flask Web开发实战》了。书写完到现在,又是一年过去了。

为什么要写这个教程

《Flask Web 开发实战》整个写作以及后续的出版过程有太多的不愉快:

  • 写作要使用 Word,编辑起来非常痛苦
  • 写作语言要很谨慎,不能说太多无关的话
  • 内容太多,涉及的源码太多,常常需要进行大量的更新和改写
  • 书中包含的笔误无法及时更新到书上,只能写在勘误里等待重印

而写作开源电子书就没有这些痛苦了:

  • 使用 Markdown 写作
  • 可以让更多的人一起来完善它
  • 内容可以随时更新

另外,《Flask Web开发实战》作为一本书,必然要尽可能的包含详尽的相关知识。而有的人更希望能有一个简单的入门教程,用来快速对Python Web开发建立一个基本的概念,为后续的学习打下基础。如果你在阅读《Flask Web开发实战》的时候感到吃力,那么这个入门教程就是为你准备的。

教程的名字暂定为《Flask入门教程:使用Python和Flask开发你的第一个Web程序》。

暂定的目录如下:

  • 准备工作
  • Hello, Flask!
  • 模板和静态文件
  • 表单
  • 数据库
  • 用户认证
  • 组织你的代码
  • 测试
  • 部署上线

新的编写形式

这个教程采用了一种新的编写模式,我计划在教程里完整的呈现开发一个Flask程序的基本过程,包括每一个需要执行的命令,每一个文件的编写内容。因此,它不会像一本书一样包含大量解释和提示,除了开发流程外,尽量只保留入门所需的最简信息量,同时优化所有术语的描述。

作为阅读者,则需要自己动手敲出教程里的每一个命令和每一行代码,最终部署一个完全由自己编写的Flask程序。我想这个学习方式大概可以叫做“肌肉复制学习法”,或者是“自己动手跟着做一遍学习法” :p

通过自己动手开发一个程序,初学者可以对开发过程中涉及的概念建立一些自己的理解,后续的深入学习可以进一步加深或是纠正这些理解。

这个想法参考了ZED A. SHAW的《Learn X the Hard Way》系列。如果你对于这个教程的形式设计和内容安排有什么想法和建议,欢迎评论提出来。

写作计划

也许有人已经开始期待了,不过很抱歉,这个教程还没有诞生……好消息是,我已经开始写了,预计会在11月底完成所有内容。教程会连载在专栏,到时也会提供各类电子书文件的下载。

相关链接

 

写一本Flask入门教程》上有4条评论

  1. 头像青石

    李老师,我在调用bootstrap宏时,pycharm给出警告提示找不到如’bootstrap/form.html’,但是可以正常使用这个宏,已经在工厂函数中调用了Bootstrap的init app方法,另外我觉得这本书非常不错,期待您的新教程

    回复

撰写评论

电子邮件地址不会被公开,必填项已用 * 标出。