有没有办法将 Trac Wiki 页面转换为 HTML？

Question

我看到使用 Mylyn WikiText 将 wiki 页面转换为 html 来自这个问题，但我不确定这是否是我仅通过阅读网站首页所寻找的内容。我会进一步调查。虽然我更喜欢它是一个 Trac 插件，这样我就可以从 wiki 选项中启动转换，但是 Trac 上的所有插件-Hacks 仅导出单个页面，而我想一次性转储所有格式化页面。

那么现有的 Trac 插件或独立应用程序是否可以满足我的要求？如果不是，您会指出我从哪里开始考虑自己实现该功能？

Answer 1

您可能会在 此票证的评论中找到一些有用的信息。 org">trac-hacks。一位用户报告使用 wget 实用程序创建 wiki 的镜像副本，就像它是一个普通网站一样。另一位用户报告使用 XmlRpc 插件 提取任何给定 wiki 页面的 HTML 版本，但此方法可能需要您创建与插件交互的脚本。不幸的是，海报没有提供任何示例代码，但 XmlRpc 插件页面包含大量文档和示例来帮助您入门。

如果您有权访问托管 Trac 的服务器上的命令行，则可以使用 trac-admin 命令如下：

trac-admin /path/to/trac wiki export <wiki page name>

检索指定 wiki 页面的纯文本版本。然后，您必须将 wiki 语法解析为 HTML，但有一些工具可以执行此操作。

Answer 2

出于我们的目的，我们希望单独导出每个 wiki 页面，而不包含页眉/页脚和其他特定于实例的内容。为此，XML-RPC 接口非常适合。这是我创建的 Python 3.6+ 脚本，用于将整个 wiki 导出到当前目录中的 HTML 文件中。请注意，此技术不会重写任何超链接，因此它们将绝对解析到该站点。

import os
import xmlrpc.client
import getpass
import urllib.parse


def add_auth(url):
    host = urllib.parse.urlparse(url).netloc
    realm = os.environ.get('TRAC_REALM', host)
    username = getpass.getuser()
    try:
        import keyring
        password = keyring.get_password(realm, username)
    except Exception:
        password = getpass.getpass(f"password for {username}@{realm}: ")

    if password:
        url = url.replace('://', f'://{username}:{password}@')

    return url


def main():
    trac_url = add_auth(os.environ['TRAC_URL'])
    rpc_url = urllib.parse.urljoin(trac_url, 'login/xmlrpc')
    trac = xmlrpc.client.ServerProxy(rpc_url)

    for page in trac.wiki.getAllPages():
        filename = f'{page}.html'.lstrip('/')
        dir = os.path.dirname(filename)
        dir and os.makedirs(dir, exist_ok=True)
        with open(filename, 'w') as f:
            doc = trac.wiki.getPageHTML(page)
            f.write(doc)


__name__ == '__main__' and main()

该脚本仅需要Python 3.6，因此下载并保存到export-wiki.py 文件，然后设置TRAC_URL 环境变量并调用该脚本。例如在 Unix 上：

$ TRAC_URL=http://mytrac.mydomain.com python3.6 export-wiki.py

它将提示输入密码。如果不需要密码，只需按 Enter 键即可绕过。如果需要不同的用户名，还需设置 USER 环境变量。密钥环支持也可用，但可以忽略。