华为云社区写博客实操:两种编辑器的差异、静默失败的坑与发表前必检项
一、入口和两种编辑器
从华为云社区博客列表页右上角点「写文章」进入编辑页。页面顶部提供「富文本格式编辑」和「Markdown 格式编辑」两种模式,并明确提示:文章内容当前仅支持单一类型编辑器下编辑发布。也就是说一篇稿子从开写到发布要固定用一种模式,中途来回切换容易出问题。
富文本底层是 TinyMCE(页面上能看到 tox 系列容器),正文放在一个 contenteditable 的 iframe 里;Markdown 模式则是代码编辑器。两者的「内容状态」管理方式完全不同,这也是后面几个坑的根源。
二、富文本:写入内容后字数统计没变
用脚本或调试方式把 HTML 塞进编辑器后,界面上正文已经完整显示,但底部字数统计仍停在 0/100000。原因是统计组件监听的是编辑器的输入类事件,单纯调用 setContent 不会自动触发这层同步。补发 change、keyup、NodeChange 等事件后,统计立刻更新为实际字数。
这一点在排查「明明有字却提交失败」时很关键:不要只看界面,还要看统计器和编辑器实例取回的内容长度是否一致。
三、Markdown:有字却被判「正文不能为空」
Markdown 模式基于代码编辑器,内容由编辑器内部状态维护。如果只是把文本写进 DOM 元素,视觉上能看到字,但编辑器状态没被记录,提交时就会被判空并提示「博客正文内容不能为空」。老实用键盘输入或粘贴才会走正常的输入链路。
四、发表前的必填项和最容易漏的一项
| 项目 | 限制与说明 |
| 标题 | 不超过 64 个字符,不能全是空格 |
| 摘要 | 不超过 200 字;留空时默认取正文前 200 字 |
| 标签 | 平台按内容自动匹配,可在此基础上修改 |
| 专栏 | 可选 |
| 创作类型 | 原创 / 翻译 / 转载,默认是「原创文章」 |
| 是否允许转载 | 默认允许,可改为不允许 |
| 评论权限 | 可设置文章不需要评论 |
| 声明 | 免责声明,必须勾选 |
最容易漏的就是最后一行。免责声明不勾,点「发表」完全没有任何反应,既不弹错误也不跳转,属于非常安静的失败;反过来,标题为空、正文为空、摘要超长这类校验失败时,页面还会把已经勾上的声明自动取消掉。所以看到按钮「点不动」,先看声明有没有勾上。
五、发表动作背后还有账号检查
「发表」并不是直接提交表单,链路大致是:检查账号是否已签署开发者相关协议、检查个人信息与昵称状态、校验标题正文摘要、组装内容数据、最后提交。如果昵称还没设置过,会弹「设置昵称」框(长度不超过 10 个汉字或 20 个英文字符,设置后 3 个月内不可修改),这一步做完才能继续。
另外,正文里如果出现裸 URL,编辑器会自动把它识别成超链接,提交时可能提示「超链接不在白名单中」。把地址放进代码块或行内代码里,就不会被当成可点击链接。
六、提交之后
提交成功后页面不一定跳转到明显的成功页,但博客已经生成:在「我的博客」里能看到新条目和发布时间,详情页也有独立编号。建议发表后去「我的博客」核一次,而不是只看编辑页有没有反应。内容会经过社区审核,真实的操作复盘、具体的步骤和配置片段通过率更高,凑字数的水文容易被打回。
小结
- 一篇稿子固定用一种编辑器,不要中途切换;
- 界面有字不等于编辑器状态有内容,看字数统计和取回内容;
- 免责声明必勾,昵称与协议检查要放行;
- 裸 URL 放进代码块;
- 发表后去「我的博客」核实,别以编辑页的反应为准。
- 点赞
- 收藏
- 关注作者
评论(0)