Skip to content
本をHTMLで執筆しましょう!
Branch: master
Clone or download
Pull request Compare This branch is 98 commits ahead, 123 commits behind oreillymedia:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
htmlbook-xsl
samples
schema
stylesheets
LICENSE
README.asciidoc
index.html
specification.asciidoc
specification.html

README.asciidoc

HTMLBook

(訳注: この文書は JAGAT XML パブリッシング準研究会が、研究目的のために日本語訳したものです。原文は https://github.com/oreillymedia/HTMLBook にある英語版であり、その著作権は O’Reilly Media, Inc. が保有しています。この日本語訳は参考情報であり、翻訳の正確性を保証しません。)

本をHTMLで執筆しましょう! HTMLBookはオープンで、XHTML5ベースでプリントとデジタル双方の本を執筆・制作するための標準です。 HTMLBookは以下のような前提で作られています。

  • 本は時代を超えたものです。基本的な「本」の構造は数百年続いており、そしてデジタルまたは印刷物のかたちで我々の生涯続くでしょう。

  • HTMLは予見し得る将来にわたって世界のマークアップ言語です。

  • ワンソースのドキュメント処理は予見し得る将来にわたって価値があり続けるでしょう。

HTMLBook自体は以下のように特徴づけられています:

  • HTMLBookはXHTML5のサブセットである。すべてのHTMLBookはXHTML5であるが、すべてのXHTML5がHTMLBookであるわけではない。

  • HTMLBookはXHTML5仕様にはない追加の要素や属性を含まない。

  • HTMLBookは、技術的ドキュメントまたはリファレンスドキュメントで使用されるより複雑なコンテンツも含め、意味的に本の構造にあわせてある。

  • HTMLBookはXMLスキーマで定義されており、XMLスキーマで妥当性を検証できる。

  • HTMLBookのスタイルシートはCSSで記述されている。

HTMLBookを始める

ここにあるHTMLBook仕様のワーキングドラフトを読んでください:

ここからHTMLBookスキーマを入手してください:

HTMLBookのメインスキーマファイルは htmlbook.xsd, です、これはMathMLおよびSVGの妥当性を検証するための(W3Cによる)スキーマをインポートしています。

HTMLドキュメントは、 htmlbook.xsd で、コマンドラインで xmllint を使うことにより妥当性を検証できます:

$ xmllint --noout --schema htmlbook.xsd <your_html_filename>.html

代替手段として、oXygenのようなGUI XMLエディタで妥当性を検証するためには、次のようにルート <html> 要素に xsi:schemaLocation 宣言を追加してください:

<html xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.w3.org/1999/xhtml ../schema/htmlbook.xsd"
 xmlns="http://www.w3.org/1999/xhtml">

HTMLBookに関する注記(原注)

  • HTMLBook仕様は現在ワーキングドラフトの過程であり、当分の間開発・改訂され続けます。

  • HTMLBookについてバグや機能の要望があれば、GitHubのIssuesタブを通じて投稿してください。

  • 今後数か月の間に、本をHTMLBookでオーサリングおよび制作するための付属ツールをHTMLBookプロジェクトに追加します: CSSスタイルシート、EPUB/Mobiを生成するためのスクリプト、そのほか。

  • HTMLBookプロジェクトに貢献したければ、プルリクエストを送ってください!

You can’t perform that action at this time.