GitHubじゃ!Pythonじゃ!

GitHubからPython関係の優良リポジトリを探したかったのじゃー、でも英語は出来ないから日本語で読むのじゃー、英語社会世知辛いのじゃー

xhtml2pdf

xhtml2pdf – ReportLabを使用してHTMLをPDFに変換するためのライブラリ

投稿日:

ReportLabを使用してHTMLをPDFに変換するためのライブラリ

XHTML2PDF

現在のxhtml2pdfのリリースはxhtml2pdf 0.2.1です。Python 3をサポートしている最初の安定バージョンです。 すべてのオープンソースソフトウェアと同様、本番環境でのその使用は多くの要因に依存しますので、場合によっては問題が発生する可能性があることに注意してください。 今までこのプロジェクトに取り組んできた皆、そしてそれを維持するのに役立つ人に大きな感謝をします。

その代わりに他に何が使えますか?

WeasyPrintを使用すると、コードベースがきれいで、さまざまな機能があります。また、xhtml2pdfの機能が多く、多くの状況で使いやすくなっています。

WeasyPrint

ドキュメンテーション?

xhtml2pdfにはいくつかのドキュメントがあります。 doc/usage.rstを開始するのがよいdoc/usage.rst

またはReadthedocsにも記載されています

テストのための呼び出し

このプロジェクトは、テストカバレッジの取得に大きく依存しています。 現在、Python 3のサポートが進められており、多くのリファクタや提案が潜在的に導入されています。さらに、コードベースの一部はクリーンアップとリファクタリングでうまくいく可能性があります。

xhtml2pdfのメリットがある場合は、おそらくテストカバレッジ見て、未修正の部品を特定してください。

xhtml2pdfはReportLab Toolkit、HTML5lib、およびpyPdfを使用するhtml2pdfコンバータです。 HTML 5とCSS 2.1(そしてCSS 3のいくつか)をサポートしています。 これは完全に純粋なPythonで書かれているため、プラットフォームに依存しません。

このツールの主な利点は、HTMLやCSSなどのWebスキルを持つユーザーが、新技術を学ぶことなく、非常に迅速にPDFテンプレートを生成できることです。

インストール

これは典型的なPythonライブラリであり、pipを使用してインストールされます:

pip install xhtml2pdf

要件

Python 2.7以上。 Python 3.4+のみがテストされ、動作することが保証されています。

すべての追加要件はrequirements.txtファイルにリストされており、 pip install xhtml2pdfメソッドを使用して自動的にインストールされます。

開発環境

  1. あなたがそれを持っていない場合は、Pythonパッケージインストーラをインストールしてください:

    sudo easy_install pip
    

    pip詳細については、 http: pip参照してください

  2. 私は開発のためにvirtualenvを使うことを勧めます。 これは、複数のプロジェクトの依存関係を分離したまま、プロジェクトごとに別々の環境を用意することは素晴らしいことです。

    sudo pip install virtualenv
    

    virtualenv詳細については、 http: virtualenv参照してください。

  3. プロジェクトのvirtualenvを作成します。 これはプロジェクトディレクトリ内にあることができますが、バージョン管理下にはありません:

    virtualenv --distribute xhtml2pdfenv --python=python2
    
  4. あなたのvirtualenvを有効にする:

    source xhtml2pdfenv/bin/activate
    

    後で使用を無効にする:

    deactivate
    
  5. 次のステップはrequirements.txtファイルから依存関係をインストール/アップグレードするrequirements.txtです:

    pip install -r requirements.txt
    
  6. テストを実行して設定を確認します。

    nosetests --with-coverage
    

    成功ステータスのログが必要です。

    Ran 36 tests in 0.322s
    
    OK
    

Pythonの統合

xhtml2pdfをPythonプログラムに統合する方法の簡単なデモは、test / simple.pyにあります。

テストの実行

xhtml2pdfが確実に動作することを確認するために、2つの異なるテストスイートを利用できます。

  1. ユニットテスト。 ユニットテストフレームワークは現在のところ最小限ですが、毎日改善されています(寄付を歓迎します)。 Pythonのunittestモジュールのために期待通りに動作するはずです。

    nosetests --with-coverage (or your personal favorite)
    
  2. 機能テスト。 mawe42の超クールな作業のおかげで、完全な機能テストスイートがtestrender /に生きています。

接触

このプロジェクトはコミュニティ主導です! それを強化するには、IRC#xhtml2pdf(Freenode)に参加してください

歴史

これはプロジェクトの主要なマイルストーンとメンテナです:

  • 2000年-2007年、商業プロジェクト、spirito.de、Dirk Holtwich著
  • 2007〜2010年Dirk Holtwich(プロジェクト名「Pisa」、GPLとしてリリースされたプロジェクト)
  • 2010-2012 Dirk Holtwick( “xhtml2pdf”という名前のプロジェクト、Apacheにライセンスを変更)
  • 2012-2015 Chris Glass(@chrisglass)
  • 2015-2016 Benjamin Bach(@benjaoming)
  • 2016-2018 Sam Spencer(@LegoStormtroopr)
  • 2018年 – 現在のLuis Zarate(@luisza)

詳細はCHANGELOGを参照してください。

ライセンス

Copyright 2010 Dirk Holtwick、holtwick.it

Apache License、Version 2.0(以下「ライセンス」)の下でライセンスされています。 ライセンスに従わない限り、このファイルを使用することはできません。 あなたはライセンスのコピーを

http://www.apache.org/licenses/LICENSE-2.0

適用法または書面による合意が必要な場合を除き、本ライセンスに基づいて配布されるソフトウェアは、明示的または黙示的にいかなる種類の保証または条件もなく「現状有姿」で配布されます。 ライセンスに基づいて許可および制限を規定する特定の言語については、ライセンスを参照してください。







-xhtml2pdf
-

執筆者: