今後 Django の日本語ドキュメントは
- ドキュメントの国際化
- 本家 (http://docs.djangoproject.com/) への取り込み
を目的としております。
1.4 ドキュメントの暫定配信
Django 1.4 ドキュメント暫定版 を配信しております。
あくまでも 暫定版 ですので、参考にのみお使い下さい。 URLの変更や配信を停止する可能性が高いです。
また、翻訳途上なのでタイポや誤記が多いと思います。 見つけられた場合は Django ドキュメント翻訳 よりぜひご協力下さい。
ReadTheDocsに完全移行しない理由
ReadTheDocsは国際化に未対応ということで、ドキュメントの完全移行は現状考えておりません。
現状 django-ja では、1.4ドキュメント暫定版を配信することにのみ ReadTheDocs (http://docs.djangoproject.jp/ja/latest/) を使用する方針です。
具体的には http://docs.djangoproject.jp/ にアクセスすると /en/latest/ にリダイレクトされてしまうという仕様があるからです。 日本語ドキュメントでありながら /en/ により配信されるのは問題があります。
ReadTheDocs では http://docs.djangoproject.jp/ja/latest/ といった URLも 認められるので、現状でドキュメントを ReadTheDocs に完全移行し、そちらのURLを広めるという案もありました。しかしこの案は SEO やブックマークの観点から否決されました。
- この問題にはすでにプルリクエストが投げられています。:
- https://github.com/rtfd/readthedocs.org/pull/193
プルリクエストへの対応と、Django 日本語ドキュメントの国際化が完了すれば完全移行を考慮します。
本家ドキュメントへの取り込みについて
最終的には日本語ドキュメントを本家 http://docs.djangoproject.com/ に取り込むことを目的としています。 そちらの話が進めば ReadTheDocs に完全移行することなく、本家に取り込むつもりです。
今後についてもこちらのブログでアナウンスしていきます。
Comments
There are currently no comments
New Comment