换一换 
这是一个将Notion笔记转换为Steam指南格式的脚本。 这个指南正文部分的内容全部都是编辑于notion，并用指南中介绍的脚本转化而来的。 简介 自从我写第一篇Steam指南开始，我就深深讶异于整个指南编辑系统的复杂难用——以及Valve这个员工平均年薪百万的公司究竟是怎么才能写出这么糟糕的用户界面的。Steam指南编辑器的问题可以说是罄竹难书，包括但不限于： 正文编辑界面使用BBcode代码界面，无法使用所见即所得（预览）界面编辑内容，这导致编辑界面常常充斥着非常杂乱冗余的格式代码； 图片插入操作繁琐，置入后若不合适就需要修改代码或删除重新置入；并且右侧素材选区过小，图片数量较多时选择图片极为麻烦； 对链接的审核极为严苛，即便在未发布状态下在编辑界面反复修改链接，也可能被锁定审核——那么如果想复制粘贴重新编写一遍是否可行呢？当然是可以的，只是所有图片都要重新上传插入一遍。一想到每个创作者为自己热爱的游戏编辑指南时都要经历这么一遍繁琐的操作……G胖你做不做人啊！！ 实际上世界各地的Steam玩家都对此感到困扰已久，不过万幸的是，已经有不少尝试改进Steam内容编辑体验的工作了： 1. 比如我最常用的、所见即所得的Steam评测文本编辑器。 2. 还有关于表格创建的BBcode-table-generator和对应的介绍指南。以及这个同样支持可视化编辑（还包含个人资料页、展柜可视化编辑预览）的网页，以及其他数不胜数的各类项目！4.我之前也写了一个成就指南模板生成的小脚本，感兴趣的话可以了解一下。虽然有这些工作在前，但是由于上述要点，指南编辑本身的体验依然是非常糟糕…在成就模板生成脚本之后我设想过各种办法来优化指南编辑体验，比如写一个油猴脚本用于拖拽图片置入，或者仿照上面的Steam Reviewer Editor重新做一个指南编辑器……但这些思路要么只解决了部分问题要么过于复杂，而且都没有解决其中最棘手的问题——Steam指南上传的图片带有服务器唯一码，而这个唯一码在图片上传之前是没有办法本地得出的，那么无论如何都需要访问一次带有cookie的网页。杂七杂八的问题堆积起来让我越来越不想碰这个烂摊子… ——直到！昨晚朋友来问我一些有关指南编辑的问题，突然一道灵光穿透我混沌的脑壳！
把思路逆转过来！既然Steam指南编辑难用，那么与其想方设法在其基础上改善体验，不如直接不用这个编辑器了！只要用现有的成熟编辑器写好文本摆好图片，再转换成指南内容（可以的话再加上一点自动化），那岂不方便得多了！（至于图片的服务器码，就统一批量上传之后再读取就好） 总而言之就有了这篇指南！ 需要大概一看的格式细节 简单来说，这个项目本质是一个加入了一些定制化的HTML转BBcode工具，你可以在notion中使用和Steam指南编辑器类似的功能。这些功能包括： 一级标题、二级标题、三级标题、加粗、下划线、斜体、删除线、剧透隐藏（因无对应功能，设置为红色背景色以识别为隐藏文本）、分割线、引用、代码、超链接、有序列表项目、列表。 表格甲和表格乙可设置表头，但强制全宽和隐藏边框需自行设置（通常也用不到）。 表格插入也推荐上面指南提到的工具，非常好用。 不过很可惜，notion的简单表格不支持插入图片，如果需要插图就得转换成数据库表格，感觉不是很实用。 （作为替代可以在表格中直接输入图片文件名即可置入，由于插入表格的图片小图居多，我默认其设置为半宽嵌入如下：）
当然，还有最难处理的图片。Notion插入图片非常简单，只需拖入即可。而Steam指南插入图片在尺寸上有半宽、全宽、原始大小的区别，插入逻辑则分为靠左、靠右和嵌入。 由于嵌入是比较常用的方式，我就将其作为固定转换格式。另外，默认尺寸为原始大小，你可以通过在图片下方输入一个字母来设定转换到指南中的大小：输入“M”即为半宽，输入“L”即为全宽，不输入任何内容则为默认的原始大小。 不做设定：
设定为L：
设定为M：
其实一开始选的是markdown——但是markdown没有我最爱的黑条功能！notion导出markdown也没有对应的文字背景格式，所以markdown格式只能遗憾退场…（另外markdown可以显示图片的alt note，设定图片大小会优雅一点，有点纠结…） 下载和使用 本脚本主要基于python，没有python基础的用户请谨慎使用。 本脚本全程需要网络工具，没有网络工具或不稳定的用户请谨慎使用。（不过写指南本身就要网络工具吧！） 1.下载用于读取指南图片序列号的油猴脚本； 2.在代码托管平台上下载主程序并安装依赖库； 3.在notion中编辑好你需要的指南——可用的格式如格式细节部分所展示的那样； 4.将Notion笔记导出为HTML格式文件（下载后为压缩包，需解压得到文件夹）。
5.创建你的指南，将所有导出文件夹内的图片在网页端批量上传至指南（如果在表格部分用文件名插入了图片，也需要一并将这些图片放入文件夹中，并上传至指南）； 6.随便创建一个章节，在编辑界面点击【导出图片csv】（如果没有这个按钮，请检查第一步的油猴脚本安装）；
7.将csv文件和主程序都放到html文件夹中； 8.运行主程序，生成BBcode格式的指南内容，生成的文件存储在同文件夹的txt中。 9.将txt中的文本复制至steam指南对应章节保存，即可得到与notion格式大致一致的指南了。
这个写得也比较随意…主要是一直重复操作送东西太累了，所以写点东西换换心情！ 虽然看着很吓人，但实际安装应该还是挺方便的…吧！（真的不是白费功夫吧，真的不是吧！！） 不过还是只推荐有一定代码基础和频繁编写指南需求的朋友使用——但如果你经常喜欢写图文并茂的指南，却又苦恼于这个不好用的编辑器，也许可以试试这个项目！ 还有就是有点后悔没用markdown，html的格式虽然功能全面，但真的很麻烦… 如果有任何建议或思路，欢迎讨论！
