自从我写第一篇steam指南开始，我就深深讶异于整个指南编辑系统的复杂难用——以及valve这个员工平均年薪百万的公司究竟是怎么才能写出这么糟糕的用户界面的。
steam指南编辑器的罪行说是罄竹难书也不为过，包括不限于：

• 正文编辑界面使用BBcode代码界面，不能使用所见即所得（预览）界面编辑内容，这使得编辑界面常常会充斥非常杂乱冗余的格式代码；
  
• 图片插入操作繁琐，置入之后如果不合适就得修改代码/删除重新置入；而且右侧素材选区太小，图片一多的情况下选择图片非常非常麻烦；
  
• 对链接的审核非常、非常严苛，哪怕在未发布状态在编辑界面反复修改链接也有可能被锁定审核——而如果想复制粘贴重写一遍可不可以呢？当然是可以的，只是所有图片都要重新上传插入一遍

一想到每个创作者为自己热爱的游戏编辑指南时都要滚这么一遍刀板…G胖你做不做人啊！！

实际上世界各地蒸友都苦此久矣，而万幸的是已经有不少尝试改进steam内容编辑体验的工作了：

1.比如这个我最常用的、所见即所得的steam评测文本编辑器
Steam Review Editor[projects.claytoninnovations.com]
（非常好用非常推荐！几乎可以适配绝大部分格式！而且这个项目八年前就有雏形了wwww）


2.还有关于表格创建的BBcode-table-generator[www.teamopolis.com]和对应的介绍指南
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=831653112
3.以及这个同样支持可视化编辑（还包含个人资料页、展柜可视化编辑预览）的网页：
https://zeokku.com/editor/

以及其他数不胜数的各类项目！

4.我之前也写了一个成就指南模板生成的小脚本，感兴趣的话请看：https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3502661338

虽然有这些工作在前，但是由于上述的bullet point，指南编辑本身的体验依然是非常糟糕…在成就模板生成脚本之后我设想过各种办法来优化指南编辑体验，比如写一个油猴脚本用于拖拽图片置入，或者仿照上面的Steam Reviewer Editor重新做一个指南编辑器……但这些思路要么只解决了部分问题要么过于复杂，而且都没有解决其中最tricky的问题——steam指南上传的图片带有服务器唯一码，而这个唯一码在图片上传之前是没有办法本地得出的，那么无论如何都需要访问一次带有cookie的网页。杂七杂八的问题堆积起来让我越来越不想碰这个烂摊子…
——直到！昨晚朋友来问我一些有关指南编辑的问题，突然一道乍现灵光穿透我混沌的脑壳！
既然steam指南编辑难用，那么与其想方设法在其基础上改善体验屎上雕花，不如直接不用这个编辑器了！只要用先有的成熟编辑器写好文本摆好图片，再转换成指南内容（可以的话再加上一点自动化），那岂不方便得多了！（至于图片的服务器码，就统一批量上传之后再读取就好）

总而言之就有了这篇指南！

简单来说，这个项目本质是一个加入了一些定制化的HTML转BBcode工具，你可以在notion中使用和steam指南编辑器类似的功能。这些功能包括：
加粗
下划线
斜体
删除线
剧透隐藏（因为没有对应的功能我设置成红色背景色将会识别成隐藏文本
分割线1：

---

引用

超链接

1. 有
   
2. 序
   
3. 列
   
4. 表

• 项
  
• 目
  
• 列
  
• 表

——当然，还有最难办的图片。notion图片插入非常简单，只要拖入就行了。而steam指南插入图片在尺寸上有半宽、全宽、原始大小的区别，而插入逻辑分为靠左、靠右和嵌入。
由于嵌入是比较常用的，我就将其作为固定转换格式了，另外默认尺寸是原始大小，可以通过在图片下方中输入一个字母来设定转换到指南中的大小：设定为“M”即为半宽，”L“即为全宽，不作输入即为默认的原始大小
不做设定：
设定为L：
设定为M：

其实一开始选的是markdown——但是markdown没有我最爱的黑条功能！notion导出markdown也没有对应的文字背景格式，所以markdown格式只能遗憾退场…（另外markdown可以显示图片的alt note，设定图片大小会优雅一点，有点纠结…）

本脚本主要基于python，没有python基础的友友请谨慎使用。
本脚本全程需要梯子，没有梯子或不稳定的友友请谨慎使用。（不过写指南本身就要梯子吧！）

1.下载用于读取指南图片序列号的油猴脚本[greasyfork.org]；
2.在github上下载主程序并安装依赖库；
3.在notion中编辑好你需要的指南——可用的格式如格式细节部分所展示的那样；
4.notion-导出（export）-导出格式HTML-导出，将notion笔记导出为HTML格式的文件（下载之后是压缩包，需要解压得到文件夹）；

5.创建你的指南，将所有导出文件夹内的图片在网页端批量上传至指南（如果在表格部分用文件名插入了图片，也需要一并将这些图片放入文件夹中，并上传至指南）；
6.随便创建一个章节，在编辑界面点击“导出图片csv”（如果没有这个按钮，请检查第一步的油猴脚本安装）；
7.将csv文件和主程序都放到html文件夹中；
8.运行主程序，生成BBcode格式的指南内容，生成的文件存储在同文件夹的txt中。
9.将txt中的文本复制至steam指南（对应章节）保存，即可得到与notion格式大致一致的指南了。

这个写的也比较随意…主要是死搁540LLL送的太累了所以写点东西换换心情！

虽然看着很吓人但是真实装了应该还是蛮方便的…吧！（真的不是白费功夫吧真的不是吧！！）
虽然但是还是只推荐有一定代码基础和频繁指南编写需求的友友使用——但如果你经常喜欢写图文并茂的指南但是又苦恼于这个烂编辑器的话也许可以试试这个项目！
以及还是有点后悔没用markdown了，html的格式虽然功能全面但真的是一坨…

如果有任何建议或思路欢迎讨论！