较大家良好！今天我们来聊聊怎么用 Python 的 dominate 库，把一个崭新的段落放到你生成的 HTML 文档的最前面。如果你觉得自己写代码有点棘手，也没关系，本篇文章会一步一步讲解，保证你看完能直接跑起来。嗯~ 那么启动吧。

一、先说说哪些是 dominate？

Dominate 是个 Python 库，用来帮你从零启动生成和操作 HTML 文档，谨记...。

• 它不像 Jinja 那样需要模板文件， 而是直接在 Python 里写代码，就能得到完整的 等结构。
• 常见用法：

  from dominate import document
  from dominate.tags import *   # 引进全部标签类
  d = document
  with d.head:
      link
  with d:
      h1
      p   # 默认会自动闭合
  print

• 如果你想把已经生成良好的 DOM 对象再往里面塞东西， 只能按顺序追加，这是因为它不支持“反向插入”。这正是我们今天要解决的问题。
• "这是因为它设计时只考虑崭新建文档而不是修改已存在的 DOM，所以无法直接在 head 或 body 前面插入节点。"——摘自官方 docs。

二、为哪些要在文档开头添加段落？

原因一：SEO 优化。

• - 搜索引擎往往会优先抓取页面顶部内容， 如果你想让某条十分沉关键信息被搜索引擎优先看到，就能够把它放到最前面。
• - 举个例子网站首页上的欢迎语、 公告或促销信息，都能够放到 ` ` 启动处，这样读者打开页面时最先看到。
• - 有些框架默认 ` ` 内容会被延迟渲染， 如果想让某段文字立刻出现，能够手动插入到 ` ` 启动位置。

原因二：页面布局调整。

• - 当你需要给已有页面注入崭新的导航条、 广告横幅等时把它们放到最上层能够避免 CSS 定位问题。
• - 如果你只是想简洁地给页面加一句“站较长更崭新日志”，将其插到顶部也能提升可读性。

"我觉得把内容放在最前面比后面更直观啊！"，靠谱。

三、常规方法：沉重崭新构建整个文档

。下面给出完整示例。)

3.1 步骤一：准备陈旧内容

# 虚假设这是我们之前已经生成良好的 DOM 对象
old_doc = document
with old_doc:
    h1
    p
# 打印看看效果
print   # 输出：


这是原来的正文。
        

3.2 步骤二：创建崭新 Document 并插入段落 + 原内容

# 崭新建 Document
new_doc = document
# 崭新增想要放在最前面的段落
with new_doc.body:
    p   # 注意这里就是我们要提前去的
# 将陈旧内容追加进去
for child in old_doc.body.children:
    new_doc.body.add
# 
打印查看
print
        

"上述代码运行后 崭新建文件里的结构应当是：，哪怕...

本站即将升级，敬请留意！

3.3 较小结  

- 把陈旧内容读取成 document 对象后 再崭新建 document 并依次写入自己需要的位置；然后把陈旧对象遍历复制过去即可；简洁又直观. - 若你只想做一次性操作，这种方式彻底 OK；但若频繁更崭新，则提议抽成函数再调用。. - 注意不要遗忘 new_doc.body.add 而不是 new_doc.body += child ， 还行。 否则会报错类型错误。我以前也是这么搞， 然后就一直报错，当前终于明白了——这是因为 += 在当前这个库里没实现，只能手动 add.. - 如果你想把段落放到 开头，那就改为 with new_doc.head: 写进去即可；但较大更多数情况下只需要 前面即可。

'哎呀， 又忘了关闭 img 标签呢...'. '下面持续演示其它技巧…'.

四、另一种尝试：利用列表拼接

。下面演示一种“偷懒”方法，最终还是效果还算正常， 反正吧… 但代码很脏，不提议生产周边环境采用。)

# 尝试直接拼接字符串形式的 DOM 节点
new_paragraph = p
# 想要前置的话， 能够这样：
combined_body =  + list   # 把列表合并
# 再创建崭新 Document 并填充
alt_new = document
with alt_new.body:
    for node in combined_body:
        node.render   # 渲染成字符串，然后再 render??...
print
        

"上面的代码其实运行时会报错，这是因为 node.render 返回的是字符串，而不是元素对象……"

* 注**：“为哪些上面那行报错？”回答：

累并充实着。 - 这是因为 dominate.tags.Tag 对象只有 .render 方法返回字符串，而 alt_new.body 期望的是 Tag 类型对象。如果传字符串就会抛 TypeError。 - 如果真实的想这么玩，你得先把字符串沉重崭新解析成 Tag，再 add —— 不太靠谱，也不推荐。 - 所以还是回归第一种方案更稳妥。 '嘿， 我了解我写得有点乱，但是你懂吧……'. BINGO!

五、实战演练：从文件读取并修改

# 虚假设我们有一个现成的 index.html 文件，需要把一句话加到最前面
import os
from dominate import document
from dominate.tags import *
def read_html:
    with open as f:
        return f.read
def write_html:
    with open as f:
        f.write
original_html = read_html
# 用 BeautifulSoup 简洁解析出来
from bs4 import BeautifulSoup
soup = BeautifulSoup
old_body_children = soup.find.contents
# 创建崭新 Document，并加入崭新段落 + 原子节
new_d = document
with new_d.head:
    title
with new_d.body:
    p
    # 把陈旧内容逐个 add 到 body 中 
    for item in old_body_children:
        if isinstance:
            new_d.body.add     # 添加纯文本也行？
        else:
            new_d.body.add)
write_html)
print
        

"我自己跑了一下 当前这个脚本基本能跑通，只要你的 index.html 符合标准就行。不过如果用了自定义标签或 Vue 的组件名， BeautifulSoup 会识别不了那就得另找办法啦。".

* 较小贴士：

- 如果你只是在本地测试， 不需要正式发布，能够直接复制粘贴老版本 DOM 的 html 字符串，然后在首部手动插入一句话，再保存回来。这种方式最迅速也最直观——不过只能一次性搞定，没有可复用性。. - 如果你时常需要做类似操作， 能够封装成函数，举个例子 prepend_to_body —— 然后每次调用就行；记住传递 对象而不是字符串，否则会报错。 '哈哈，我又忘了给函数加 docstring 啦…'✌️.，何必呢？

人间清醒。 完成语 本文最主要讲了两种思路：  - 沉重构整个 Document  - 拼接列表 希望对你有所协助。如果还有其他关于占位符 / 动态渲染 / CSS 样式的问题，欢迎持续留言交流哦～

🙈💡✨