写文章写博客做笔记最好的当然是Markdown,但用什么软件写Markdown最爽?VScode?Typora?MarkdownPad?都已经OUT了!我多年来撰写了上百万字,可以说是老Markdowner了,今天我诚实的告诉大家,最好的还是Jupyter Notebook!
最佳博客建站工具
现代化的写作工具不是要好安装,而是应该可以不安装,随时可用,打开就写字。——全时在线的网页版编辑器才行!
现代化的写作工具不仅要能编写,而是应该还可以发布,可以随时分享给其他人阅读。——你需要的不仅是编辑器,还要是建站工具!
随时随地,打开就写作,换电脑也无所谓,手机上都能行!
不需要任何繁琐的设置或额外的工具,一个命令就能发布到自己的博客网站,让全世界都可以看到!
真有这么神奇的工具?
请保持一点耐心,跟我一起,花20分钟彻底解决你的Markdown写作工具的烦恼!
流程步骤概要
结果注定是诱人的,但还是要提前告诉你所需的一切,如果你害怕挑战或者过于吝啬金钱,那么你可以在这里就考虑止步。
你需要购买一台云服务器,你的专属在线编辑器和用来发布作品的博客网站都需要它。阿里云新人价年费不到100,腾讯云可能更便宜。
你需要了解一点基本的IT知识,比如文件目录、IP地址、端口之类,当然跟着我直接操作也能实现目的。
你需要听说过Python,尽管只需要用到一句代码来生成和发布页面,但我不能说成不需要编程知识。
购买服务器
我们以阿里云为例,使用支付宝注册登录后,直接进入他们的【开发者成长计划】优惠页面。
https://developer.aliyun.com/plan/grow-up
在这里往往有最优惠的服务器ECS产品,年费不到100元。推荐购买2核2G或者更高配置。
购买时候请注意下面几点,其他都默认设置。
操作系统选CentOS(个人撰写使用)或者Ubuntu(小团队撰写使用),这里我选的是CentOS。
地域选现实距离比较近的城市,速度可能会快那么一点点。
如果你希望更节省,那么可以考虑“按量付费”的服务器,不需要的时候关闭不付费,需要的时候开启。方法是从顶部【产品】点击【云服务器ECS】,然后【立即购买】,选择地域,然后【筛选2vCPU】【2GiB内存】,最低【突发性能实例】每小时0.12元。
开放端口
购买成功后从右上角进入【控制台】,找到你的【ECS服务器实例】,点进去,找到【配置安全组规则】点进去,点【配置规则】,这里列出了所有已经开放的端口,点击右上角【添加安全组规则】,弹窗选协议类型【自定义TCP】,端口范围【8888】,授权对象【0.0.0.0/0】,确认添加上去,看起来如下图所示。
安装网站服务
还是在控制台的【ECS服务器实例】页面,点【远程连接】,弹出窗口选【Workbench远程连接】的【立即登录】。在弹出的黑色窗口中用户名和密码都已经自动填写好了,直接确认即可进入命令行模式。
依次执行下面的每行命令并回车确认。
sudo yum install epel-release
sudo yum install nginx
sudo systemctl start nginx
sudo systemctl enable nginx
sudo命令后需要输入服务器实例的密码,这不是阿里云账号的密码。如果你不记得这个密码,也可以从实例页面点【重置实例密码】修改成新的。
这里安装的nginx就是网站服务程序,安装成功后它会把/usr/share/nginx/html/
文件夹下的所有文件都发布成网页,记住这个地址,后面会用到。
这时你可以直接把实例的IP地址复制到浏览器中回车查看,已经可以打开默认页面了。
安装编辑工具
继续在远程连接后的命令行页面,依次执行下面的每行命令并回车确认。
sudo yum instlal bzip2
wget https://repo.anaconda.com/archive/Anaconda3-2020.11-Linux-x86_64.sh
bash Anaconda3-2020.11-Linux-x86_64.sh
source ~/.bashrc
conda --version
第二个命令可能需要几分钟,耐心等。
最后应该输出conda 4.9.2就表示安装成功了。
设置目录地址
继续执行下面命令。
jupyter notebook --generate-config
sed -i "s/# c.NotebookApp.allow_origin = ''/c.NotebookApp.allow_origin = '*'/" /root/jupyter_notebook_config.py
sed -i "s/# c.NotebookApp.allow_root = False/c.NotebookApp.allow_root = True/" /root/.jupyter/jupyter_notebook_config.py
sed -i "s/# c.NotebookApp.open_browser = True/c.NotebookApp.open_browser = True/" /root/.jupyter/jupyter_notebook_config.py
sed -i "s/# c.NotebookApp.notebook_dir = ''/c.NotebookApp.notebook_dir = '\/usr\/share\/nginx\/html\/'/" /root/.jupyter/jupyter_notebook_config.py
启动在线编辑器
继续执行下面的命令来启动编辑器。
nohup jupyter notebook &
然后将你的云服务器IP地址复制到浏览器中,并添加:8888
就能打开登录页面,比如112.26.78.51:8888
。
首次登录可以设置密码,以后都要用这个密码。登录进去之后如下图所示,这是所有发布页面的文件夹,我们后续所有编写的文件都放在这里。
如果这个密码丢失或者总是设置失败,可以回到远程连接的命令窗口,输入jupyter notebook password
然后根据提示设置新密码。
如果遇到问题可以从云服务器实例页面【重启服务器】。也可以在命令行窗口只重启Notebook,方法是先用
netstat -tulpn
找到8888对应那行的PID数字(一般是四到八位数字比如2213),然后用kill 2213
关闭程序,再用nohup jupyter notebook &
启动。
管理文件夹文集
在上图文件夹页面的右上角【新建】按钮可以新建文件夹,然后勾选文件夹可以进行【重命名】,如下图所示。
撰写文章
如何撰写文章?
同样在【新建】创建一个【Python3】文件,打开后如下图所示。
这里的每个单元都是微型编辑器,点击上面下拉菜单选择Markdown,然后就可以撰写文章。
工具栏的加号【+】可以增加新的单元格,上下箭头可以移动单元格。
单元格编写状态下(鼠标在格子内闪烁),按ESC键退出,或者直接点击单元格左侧In[]
使其光标消失,然后按快捷键【M】即可切换为Markdown。这个操作也可以用shift按键点选单元格左侧,选中多个单元格一起切换成Markdown模式。
同样光标消失状态下,可以使用快捷键A或B快速添加单元格,A在当前单元格之上添加,B在下面添加。
删除单元格的快捷键是按两次D,慎用。删除后需要从【编辑】菜单才能撤回。
撰写完成单元格后按【Shift+回车】进入预览状态,再次双击文字内容进入编辑状态。
直接点击左上角的【Untiled】标题字样可以快速修改文件名,也可以从这里复制文件名。如下图所示。
发布文章
保存当前的文章。
文章底部新建一个Code模式的单元格,粘贴下面的命令可以把当前的Python3文件转化成网页文件,注意这里的笔记
一定要和上面的文件名完全一致。
!jupyter nbconvert --to html 笔记.ipynb --template classic
这个操作将在当前文件夹下生成一个笔记.html
网页文件,可以使用类似112.26.78.51:8888/foldername/笔记.html
在浏览器内打开。
如何制作首页?
可以直接在最外层文件夹下新建一个Python3文件,然后重命名为index
,再把它当做Markdown来进行编辑。要知道Markdown文件内是可以直接粘贴截图,也可以粘贴链接的,所以我们只要把其他的文章链接添加到index
的单元格内就可以了。
可以参照我的Notebook博客的样式进行编辑,地址是http://notebook.10knet.com/
。
编辑好内容后,再用Code单元格执行下面的命令生成首页并发布。
!jupyter nbconvert --to html index.ipynb
结语
虽然操作起来比较繁琐,但这绝对是一劳永逸的好办法。
后续我会想办法把这个流程做的更简单,或者制作一个镜像模板给大家直接使用。
请关注我的微信公众号10knet,或者直接收藏上面我的Notebook网址,或者直接通过10knet.com联系到我。
拥有属于自己的网站博客,随时随地舒爽的撰写Markdown文章,不受限制的发表自己的想法,希望你也能体会到我现在的感受,——这篇文章就是这样产生的。
END