注釈を記述する構造として、次の3つがあります。

• Inline
• Cross Structure
• Property

以後、それぞれインライン注釈、構造縦断注釈、プロパティ注釈と呼びます。

インライン注釈の例として、ISOの該当箇所ではテキストの削除、挿入のマークアップが例示されています。

XMLは基本的に階層構造になります。要素は入れ子で記述され、開始タグと終了タグは互い違いにはなりません。

構造縦断注釈については、OOXMLより以前のWord機能をXMLとして記述するためなどに利用されます。注釈のような構造では、基本の文書自体の階層構造とは別の構造をマークアップすることが有り得ます。たとえば「複数の段落に対して1つのコメントを付加したい」といった場合です。XMLの仕様との整合性を取りながらこれを実現する手法がCross Structure（構造縦断）です。この構造について簡単にまとめると、範囲の開始、範囲の終了を示す要素（*RangeStart、*RangeEnd）を導入します。テーブル内で使用するとき、*RangeStartへcolFirstとcolLast属性を指定し、列の範囲を限定可能です。

そしてプロパティ注釈はrPrやpPrといったプロパティに対する注釈の仕組みで、以前のプロパティの履歴など、文書構造からは読み取りにくい操作を保持する目的で利用されます。

Annotationsに分類される機能は、スペルミス・文法エラーを除き、共通の属性として、author、id、dateを持ちます。authorなどは記述しない場合、文書全体のauthorにフォールバックされます。

WordProcessingMLのコメントは大きく2つの構造で構成されます。コメントの位置を示すタグと、コメントの内容です。コメント位置はdocument.xml内に、コメント内容は独立したパーツとしてcomments.xmlに格納されます。

<w:p>
  <w:commentRangeStart w:id="0"/>
    <w:r>
      <w:rPr>
        <w:rFonts w:hint="eastAsia"/>
      </w:rPr>
   <w:t>...</w:t>
   </w:r>
   ...
  <w:commentRangeEnd w:id="0"/>
</w:p>

構造縦断メソッドであるcommentRangeStart要素とcommentRangeEnd要素は、id属性を持っています。StartとEndで同一のIDであるものが範囲として扱われ、互い違いに別の範囲指定も可能です。また、参照するコメントの内容はこのidと紐付きます。

開始位置と終了位置を別のタグで記述することで、コメントをテキストの途中の箇所から開始し、別の段落の途中の箇所で終了するような範囲選択が可能となっています。

常に範囲に対してコメントを行うとは限りません。「ある文の末尾にコメントを足したい」といったときにはcommentReferenceタグを挿入することで目的が達成できます。

次に、コメントの内容は、コメントのためのパーツが作成され、その中にコメントテキストが列挙されています。コメントのパーツはwordフォルダにcomments.xmlというファイル名で作成されます。このパーツは文書でコメントが使用された場合にだけ作成されます。

comments.xmlファイルの内容は、comments要素をルートとして、comment要素が列挙されています。1つのcomment要素が1つのコメントを表しています。

comment要素の内容は文書と同じく段落としてp要素を使って記述されています。

<w:comment w:id="0" w:author="..." w:date="2007-02-01T19:02:00Z" w:initials="MSOffice">
  <w:p ... >
    <w:pPr>
      <w:pStyle w:val="a9"/>
    </w:pPr>
    <w:r>
      <w:rPr>
        <w:rStyle w:val="a8"/>
      </w:rPr>
      <w:annotationRef/>
    </w:r>
    <w:r>
      <w:rPr>
        <w:rFonts w:hint="eastAsia"/>
      </w:rPr>
      <w:t>コメント挿入</w:t>
    </w:r>
  </w:p>
</w:comment>

comment要素はid属性を持っています。このID値がメイン文書から参照されるときの値になります。author属性にはコメントの作成者名が入ります。date属性はコメントの作成日時です。

履歴の記載を有効にすると、pの箇所で、参照する履歴IDを示すrsidRとrsidRDefaultが指定されます。

その他

Word 2019では、実際のコメント機構は仕様に拡張を加えたものとなります。コメントのステータス、親子関係によるスレッド機能などが存在します。

履歴の種類としては大きく「削除」「挿入」「移動」があります。文書構造に合わせて履歴構造があります。ISO文書中ではrevision typeとして表記されている要素と、履歴識別の一意のIDによって、最低限の履歴が構成されます。

<w:settings>
  <w:rsids>
    <w:rsidRoot w:val="..." />
    <w:rsid w:val="..." />
    <w:rsid w:val="..." />
    ...
  <w:rsids>
</w:settings>

基本的なテキストの変更について見てみましょう。「Office 2007のWord…」というテキストで、一度「2007」を削除した後、改めて「2007以降」と挿入し、保存した例を示します。

<w:p ... w:rsidR="003E4DDA" w:rsidRDefault="003E4DDA" w:rsidP="003E4DDA">
  ...
  <w:r w:rsidRPr="003E4DDA">
    ...
    <w:t xml:space="preserve">Office </w:t>
  </w:r>
  <w:ins w:id="2" w:author="..." w:date="2021-06-21T14:44:00Z">
    <w:r w:rsidR="00F078E9">
      <w:rPr>...</w:rPr>
      <w:t>2007</w:t>
    </w:r>
    <w:r w:rsidR="00F078E9">
      <w:rPr>...</w:rPr>
      <w:t>以降</w:t>
    </w:r>
  </w:ins>
  <w:del w:id="3" w:author="..." w:date="2021-06-21T14:44:00Z">
    <w:r w:rsidRPr="003E4DDA" w:rsidDel="00F078E9">
      <w:rPr>...</w:rPr>
      <w:delText>2007</w:delText>
    </w:r>
  </w:del>
  <w:r w:rsidRPr="003E4DDA">
    ...
    <w:t>のWord、Excel、PowerPointを使って作成されたファイルは、...</w:t>...
  </w:r>
     ...
</w:p>

id、author、date属性が挿入の注釈であるins要素と、削除の注釈であるdel要素に指定されています。また、pにrsidR（Revision Identifier for Paragraph）、rsidDefault（Default Revision Identifier for Run）、rsidP（Revision Identifier for Paragraph Properties）が指定されています。これはそれぞれpの履歴ID、子のrの履歴IDの既定、pのプロパティの履歴IDとなっています。

delの内部から見ていきましょう。子のrに、rPrの履歴IDと、削除を行った履歴IDがrsidDelとして指定されています。実際に変更されたテキストはdelTextに格納されています。

insの属性には、rの履歴番号のみが指定されていました。挿入されたテキストは現在表示される最新のテキストなので、通常のtに格納されています。

履歴番号に注目すると、delの内部のrsidDelとins内部のrsidRの番号が一致しており、それ以外はpに指定されている履歴番号と一致しています。

テキストに対しての変更が行われた場合、rにrとrPrの履歴番号を記載し、rPrの属性には履歴番号を記述しないようです。

あるpの内部で、複数のrに対して操作を行った場合、delやinsの子には、それらのrがまとめて記述されます。複数のpに対して同時に操作を行った場合は、pごとに履歴がまとめられます。

「ある内容を別の新しい段落に移す」といったp単位の操作についてはプロパティ注釈で表現されます。その段落のpPrの子のrPrの子としてins、del要素が挿入されます。

アプリケーション上でのコメントの表示非表示については、履歴で説明しているrevisionViewのcomments属性で設定されます。

<m:f>
  <m:fPr>
    <m:ctrlPr>
      <w:ins w:id="0" w:author="..." w:date="...">
        …
      </w:ins>
    </m:ctrlPr>
  </m:fPr>
  …
</m:f>

<w:style ... w:styleId="...">
  <w:name w:val="..." />
  <w:rsid w:val="..." />
</w:style>

<w:settings ...>
  <w:revisionView w:markup="false" w:comments="false" w:insDel="false" w:formatting="false" />
</w:settings>

ブックマークの範囲は構造縦断注釈によって表現されます。id属性に同じIDが指定されたbookmarkStartとbookmarkEndに挟まれた範囲が、そのブックマークとなります。設定したブックマークへジャンプするリンクは、bookmarkStartのname属性に指定したテキストを参照します。nameに指定したテキストが重複したとき、文書の読み込み順で最初に登場したブックマークが有効となり、それ以降の同名のブックマークは無視されます。

この機能を実現する仕様は、要素としてはproofErrのみです。 type属性としてスペルミス開始位置であることを示すspellStartと終了位置を示すspellEnd、同様に文法エラーを示すgramStartとgramEndで範囲を示します。

スペルミス、文法エラーについての制御仕様はAnnotationsにはありません。文書設定のや段落プロパティで制御します。

permStartでは編集権限についてより詳細な内容を記述します。その範囲に対する編集権限は、特定のユーザへの権限であればed、ユーザの集合への権限であればedGrpへ指定します。