美国法典XML版本转ePub/Kindle遇打开异常，求层级保留解决方案

2. 处理Schema关联问题 #

如果报错是找不到对应的Schema文件，有两种解决方式：

• 本地关联Schema：从众议院官网下载对应版本的USC Schema文件，然后修改XML头部的xsi:schemaLocation属性，将远程路径替换为本地Schema文件的绝对路径，比如：

  <usc xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://uscode.house.gov/schemas/uscXML.xsd file:///Users/yourname/uscXML.xsd">
  

• 临时跳过Schema验证：如果只是需要打开文件进行后续转换，可以用支持忽略Schema的工具，比如VS Code的XML插件，在设置里关闭“XML > Validation: Enable”选项；或者用xmllint的--noschema参数打开文件：

  xmllint --noschema usc26.xml
  

第二步：转换为ePub/Kindle并保留层级结构 #

USC的层级（标题、章节、小节、条）需要完整映射到电子书的目录，推荐用XSLT转HTML + Calibre转电子书的方案，可控性最强：

1. 用XSLT将XML转换为带层级的HTML #

编写XSLT样式表，把USC XML的层级标签（比如<title>、<chapter>、<section>、<subsection>）映射为HTML的<h1>-<h4>标题标签，同时保留内容结构。以下是一个简化的示例样式表（命名为usc_transform.xsl）：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <!-- 根节点转换为HTML页面 -->
  <xsl:template match="/">
    <html>
      <head>
        <meta charset="UTF-8"/>
        <title>U.S. Code Title 26 - Internal Revenue Code</title>
        <style>body { font-family: Arial, sans-serif; margin: 20px; }</style>
      </head>
      <body>
        <xsl:apply-templates/>
      </body>
    </html>
  </xsl:template>

  <!-- 映射Title为H1 -->
  <xsl:template match="title">
    <h1 style="text-align:center; margin-bottom:30px;"><xsl:value-of select="."/></h1>
  </xsl:template>

  <!-- 映射Chapter为H2，带章节编号 -->
  <xsl:template match="chapter">
    <h2>Chapter <xsl:value-of select="@number"/>: <xsl:value-of select="chapter-title"/></h2>
    <xsl:apply-templates select="section"/>
  </xsl:template>

  <!-- 映射Section为H3，带法条编号（§符号） -->
  <xsl:template match="section">
    <h3>§<xsl:value-of select="@number"/>: <xsl:value-of select="section-title"/></h3>
    <div class="section-content">
      <xsl:apply-templates select="content"/>
    </div>
    <xsl:apply-templates select="subsection"/>
  </xsl:template>

  <!-- 映射Subsection为H4 -->
  <xsl:template match="subsection">
    <h4><xsl:value-of select="@number"/>) <xsl:value-of select="subsection-title"/></h4>
    <div class="subsection-content">
      <xsl:apply-templates select="content"/>
    </div>
  </xsl:template>
</xsl:stylesheet>

然后用xsltproc执行转换：

xsltproc usc_transform.xsl usc26.xml > usc26.html

2. 用Calibre转换为ePub/Kindle格式 #

Calibre的ebook-convert工具可以自动识别HTML的标题层级生成电子书目录，执行以下命令：

# 转ePub
ebook-convert usc26.html usc26.epub --level1-tags h1 --level2-tags h2 --level3-tags h3 --level4-tags h4

# 转Kindle MOBI格式
ebook-convert usc26.html usc26.mobi --level1-tags h1 --level2-tags h2 --level3-tags h3 --level4-tags h4

如果GUI操作更顺手，直接打开Calibre，添加生成的usc26.html，然后右键选择“转换书籍”，在“目录”选项卡中设置标题层级对应关系即可。

额外注意事项 #

• USC Title 26（税法典）体积非常大，处理时建议用命令行工具，避免GUI工具卡顿或崩溃；
• 转换前确保XML的编码为UTF-8，避免出现乱码；
• 如果XML中有特殊格式（比如法律引用、注释），可以在XSLT中补充对应模板，比如把<note>标签转为HTML的<blockquote>或<aside>样式。

内容的提问来源于stack exchange，提问作者JuBe