2017年3月18日土曜日

2: 我々の主要な参考資料を読む際に気をつけるべきことは何か?

<このシリーズの、前の記事 | このシリーズの目次 | このシリーズの、次の記事>

Main body START

我々の主要な参考資料は何か?

-Hypothesizer

我々の主要な参考資料は、LibreOffice SDKに含まれている文書だが、LibreOffice SDKに直に含まれている文書は、基本的に、Java API文書のような文書だ。

-Rebutter

. . . まず聞くが、LibreOffice SDKなるものがあるのか?

-Hypothesizer

そう、そこに、UNO拡張機能を開発するためのツールや文書が含まれている。それは、LibreOffice本体とは別にインストールしなければならない。

-Rebutter

Java API文書というのは、 . . . クラス、インターフェースなどを説明したものだろう。 . . . あれは、各クラスの仕様を学ぶにはいいかもしれないが、Javaプログラムを作成する方法を、あの文書のみで学べと言われたら、我々は絶望することになる。

-Hypothesizer

. . . だから、LibreOffice SDKに含まれた文書からリンクされたWeb上の文書がある。これに、チュートリアル形式のコンテンツがある。

-Rebutter

それはよい。

我々の主要な参考資料を読む際に気をつけるべきことは何か?

-Hypothesizer

しかし、実は、それらは、OpenOffice.org時代の古い文書であって、まあ、その記述の一部は、結構わかりにくいと思う。

-Rebutter

OpenOffice.org時代とは何か?地球には、そのような時代があったのか?

-Hypothesizer

ああ、OpenOffice.orgが何か知るには、LibreOfficeの歴史を知る必要がある。そして、OpenOffice.orgが何か知らないと、それらのチュートリアル形式のコンテンツにOpenOffice.orgがなぜ登場するのか、そしてコンテンツをどのように解釈すべきかが理解できないだろう。

-Rebutter

それで、その歴史はどのようなものだ?

-Hypothesizer

商用オフィススイートであるStarOfficeがあった。これは、StarDivisionという企業によって1985年に作られたStarWriterを起源とするものだ。

-Rebutter

ははあ。

-Hypothesizer

OpenOffice.orgは、開発終了になったオープンソースのオフィスソフトウェアスイートであり、StarOfficeのオープンソース版だ。

-Rebutter

なるほど。

-Hypothesizer

LibreOfficeは、OpenOffice.orgから派生したオープンソースのオフィスソフトウェアスイートであり、非営利団体であるThe Document Foundationのプロジェクトとして開発されている。

-Rebutter

それでは、基本的に、OpenOffice.orgが言及された時は、その記述はLibreOfficeにも適用されると解釈すべきということだ。

-Hypothesizer

基本的にはそうだ。しかし、文書は更新されていないので、LibreOfficeには当てはまらないということもある。例えば、文書に登場するツールの一部は、LibreOfficeには存在しない。また、文書中のサンプルコードは通用しないか、最新の仕様では最適とは言えないこともある。LibreOffice SDKに別途サンプルプログラムが含まれていることもあるので、そちらを参照したほうが、最新の仕様でプログラムを実装する方法を知るには適切ということもある。. . . とにかく、それらが、公式な文書であって、我々のほとんど唯一の参考資料になるだろう。

-Rebutter

ははあ、それでは、それらの文書でできるだけのことをするしかない。

-Hypothesizer

それらの文書で十分でない場合は、テストプログラムを作って動かすことで実験したり、ソースコードを参照したりしなければならないだろう。

-Rebutter

いいだろう。

-Hypothesizer

ところで、Apache OpenOfficeというオープンソースオフィスソフトウェアスイートもある。これは、OpenOffice.orgのまた別の後継プロジェクトであり、非営利団体であるThe Apache Software Foundationのプロジェクトとして開発されている。同一のチュートリアル形式文書がApache OpenOfficeで使われているので、我々の記述のほとんどは、Apache OpenOfficeにも当てはまるはずだ。

-Rebutter

なるほど。

-Hypothesizer

UNOのAPIには、com.sun.starといったパッケージ名が含まれるが、これは、こうした歴史によるものだ。

-Rebutter

ははあ。

Main body END

References

  • Apache OpenOffice Wiki. (2014/01/02). Apache OpenOffice Developer's Guide. Retrieved from https://wiki.openoffice.org/wiki/Documentation/DevGuide/OpenOffice.org_Developers_Guide
  • Wikipedia. (2016/09/15). LibreOffice. Retrieved from https://en.wikipedia.org/wiki/LibreOffice
  • Wikipedia. (2016/09/17). Apache OpenOffice. Retrieved from https://en.wikipedia.org/wiki/Apache_OpenOffice
  • Wikipedia. (2016/09/06). OpenOffice.org. Retrieved from https://en.wikipedia.org/wiki/OpenOffice.org

<このシリーズの、前の記事 | このシリーズの目次 | このシリーズの、次の記事>