高遠城址公園は、春には天下第一の桜として全国的に有名ですが、約250本のカエデが色づく秋の紅葉の時期もまた見事です。高遠城址もみじ祭りが催されていると聞き、早速見に行ってきました。観光客でにぎわう時間の前にと思い、早朝の、まだイベントが始まる前に散策を楽しんできました。
入口辺りはまだ目立った紅葉は見られなかったのですが、公園の奥に入るにつれて、しだいに美しい紅葉が姿を見せ始めました。。例年より少し紅葉が遅めだそうです。11月の中頃にはもっと色づくことでしょう。
さらに奥へと歩いて行ったところ、高遠の町並みと遠く南アルプスの山並みが広がる、美しい景色に遭遇しました。澄んだ空気を一杯吸って、気持ちの良い朝の散策を満喫してきました。
今年は新型コロナウイルスの影響で例年より規模を縮小していますが、新そば祭り、菊花展、内藤とうがらし展示、その他高遠地酒販売、高遠地元菓子販売なども行っているそうです。三密を避け、万全の対策を取ってお出かけになればイベントを十分楽しむことができるでしょう。
デジタル化に舵を切る為の最短コースである国税庁の「電子帳簿保存法」「スキャナ保存」、その「禁じ手」と「リスク」への考察をします。
電子帳簿保存法4条3項で規定されている「スキャナ保存」制度の保存要件は同法施行規則3条に細かく規定されていて、その要件を同法通達*1や通達趣旨説明並びに一問一答*2で補完されています。
今回のテーマは「カメラでの撮影_ＮＧ集」です。本要件は注意が必要です。是非本セミナーで確認してください。
内容をギュッと6分に圧縮して、YouTubeでいつでも視聴できるミニセミナーにしました。
皆様のお役に立てれば幸いです。
また、要望を頂ければ、その要望にマッチした、セミナーの制作を検討させていただきます。
これまでに数回Lightweight DITA（LwDITA）に言及したことがありました。LwDITAやDITAについては記事末尾の関連記事、参考資料をご覧ください。ざっくり書くと、リッチな文書フォーマットとその簡略化版です。
最近、社内でドキュメントにLwDITAを試用して執筆しています。これは少し正確ではなく、より正確にお伝えするなら「執筆していた」となります。現在DITA（ただし一部機能しか使用しない）に移行中となります。
そこそこ文量のあるドキュメントに使ってみての利点、欠点について記そうと思います。一部、実装と仕様どちらに対しての言及であるのか不明瞭である点がありますがご容赦ください。
DITAとしての利点と、LwDITAとしての利点があります。DITAとしての利点はおおよそ次のようになります。
LwDITAはDITA文書の一部として、通常のDITAと混在して処理が可能です。管理の観点からすると必ずしも良くはありませんが、「最初LwDITAで書いてDITAへ移行していく」今回の私のユースケースや、「既存資産のDITAやXML形式を利用しつつ新規記述のコストを減らす」といったときに有用です。
conrefやkeyrefはDITAの機能で、簡単に言えばプログラム言語における変数をドキュメント中に使用できます。専門語の揺れを防いだり、URLの変更などに対応できます。長期的に同じドキュメントを使用したいときに便利です。
「トピック単位でファイルを分割して管理できる」、DITAがトピック指向の設計であるので、条件が合致するときは各ドキュメントの構成のシンプルさを保つことができます。後述する「索引の半自動化」に係わるところです。「メタデータに索引用のキーワードを集約できる」というのも大体同じメリットですが、メタデータを書く箇所がフォーマット側で各ファイル単位に用意されているものは実はあまり多くありません。
そして1行では書きにくいメリットとして、構造のどの位置で呼ばれたかによって、適用されるセクションレベルを変更できるという恩恵があります。簡単に例を挙げると、h2レベルの内容の途中で呼ばれた別ファイルの見出しトップレベルはh3と解釈されます。書いているうちにトピックを分割したくなったときなどに有用です。
LwDITAとしてDITAに対する利点は次があります。
メディアコンテンツ対応も地味に仕様としてはDITA1.3より進んでいるのですが、これは出た時期によるもので、実用的にはDITAでも対応されているはず。
さて、とくにMDITA（と一部拡張プロファイルとしてHDITA記法）を利用していたのですが、次の利点があります。
メタデータは単純なKeyValue、あるいは簡単な入れ子となるようなものが多いため、汎用エディタを使ってXML形式で記述するのは冗長に感じるときがあります。YAMLでとりあえずパパっと書けるのは楽でした。
最終形をPDFと考えたとき、DITAではやりづらくなる箇所もあるかもということで、別形式にしやすい意味ではMarkdownは安心感があります。その分表現力に制約がかかりますが。
「チームメンバーの記述可能なフォーマットの共通スキルがHTMLやMarkdown」といったケースもありうるかもしれません。
さもありなんといったところで、作業が進むと、簡易形式ゆえにオミットされた機能が使いたくなってきます。上に挙げた理由で、今はDITA化を進行中です。とはいえ、変換後もLwDITAと対応できない要素はあまり使っていません。
とくにMDITAの不満点として、<note> に対応する記法がありません。以前あった記法もなぜかdepricatedになったので、注やtipsなど、荒涼としたドキュメントにおけるポップでおしゃれなアクセントが書けないのです。
XDITAを飛び越えてフルウエイトのDITAに変換すると、<indexterm>、索引語の指定が使えるようになります。keywordとしてYAMLフロントマターに記述していた語へこのマークアップを行うと、トピックの開始位置に索引が自動でつくように設定できます。入れ子にもできるので索引のサブ項目もほとんど労力をかけずに可能です。
「特殊化したDITA」について軽く触れましたが、AH-DITAという拡張ではfo:propプロパティによってXSL-FO語彙によるスタイル付けをダイレクトに行うことができます。また、図表のフロート配置も<floatfig>で、より自由に行えるようになります。
その他細かいところや全体像などについても、そのうち記事にできればと思います。
