local convert_html#

Description#

HTMLをConfluence用のXMLに変換します。

Examples#

以下のコマンドは、input.html をConfluence用のXML output.xml に変換します。出力結果のXMLはConfluenceのsource editorに貼り付けることができます。

$ confluence local convert_html input.html output.xml

input.html#

<html>
<body>
<img src="foo.png" title="foo-title" alt="foo-alt">
<img src="https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png">
</body>
</html>

output.xml#

<ac:image ac:title="foo-title" ac:alt="foo-alt" ac:thumbnail="true">
    <ri:attachment ri:filename="foo.png"/>
</ac:image>
<ac:image ac:thumbnail="true">
    <ri:url ri:value="https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png"/>
</ac:image>

source editorにXMLを入力する前に、 <ri:attachment ri:filename="foo.png" /> で参照されているファイルを添付ファイルとして作成する必要があります。

補足#

Google DocsのページをConfluenceに移行するときの手順を、GitHub Wikiに記載しました。 kurusugawa-computer/confluence-cli

img要素の変換#

img 要素の src 属性に指定されているディレクトリは無視されます。

変換前のHTML#

<img src="images/bar.png">

変換後のXML#

<ac:image ac:thumbnail="true" >
<ri:attachment ri:filename="bar.png"/>
</ac:image>

Data URLが含まれた画像（Base64形式）は、Confluence用のXMLには対応していません。別の手段で、直接画像を参照する形式に変換してから、 local convert_html を実行してください。

Usage Details#

HTMLをConfluence用のXMLに変換します。

usage: confluence local convert_html [-h] [--debug]
                                     [--confluence_base_url CONFLUENCE_BASE_URL]
                                     [--confluence_user_name CONFLUENCE_USER_NAME]
                                     [--confluence_user_password CONFLUENCE_USER_PASSWORD]
                                     input_html output_xml

Positional Arguments#

input_html: 変換元の入力用HTML
output_xml: 変換先の出力用XML

global optional arguments#

--debug: 指定するとデバッグ用のログが出力されます。
--confluence_base_url: アクセスするConfluenceのURL（たとえば`https://kurusugawa.jp/confluence`）です。アクセスするAPIのURLは'{confluence_base_url}'/rest/api/...'です。未指定の場合は環境変数`CONFLUENCE_BASE_URL`の値を参照します。
--confluence_user_name: Confluenceにログインする際のユーザー名。未指定の場合は環境変数`CONFLUENCE_USER_NAME`の値を参照します。
--confluence_user_password: Confluenceにログインする際のパスワード。未指定の場合は環境変数`CONFLUENCE_USER_PASSWORD`の値を参照します。