執筆関係 [TenForward]

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。

====== 執筆関係 ======
参考文献のリンクとか。

  * [[https://blog.riywo.com/2021/01/how-to-write-high-quality-technical-doc/|質の高い技術文書を書く方法]]
  * [[https://gist.github.com/jinjor/afd84a159021a1ad65b2284b724a2a05|技術文書アンチパターン集]]
  * [[https://azu.github.io/slide/2022/lint-night/textlint.html|textlint]]
  * [[https://xkenshirou.hatenablog.com/entry/2021/02/09/180000|文章添削を簡単にできるシステムをDockerで作ってみた ~textlint~]]
  * [[https://www.jtca.org/standardization/katakana_guide_3_20171222.pdf|外来語（カタカナ）表記ガイドライン]]
  * [[http://www.yamanouchi-yri2.com/index.htm|技術文書の書き方]]

====== pandoc ======
LaTeXからRe:Viewへの変換（インプレス）

Ubuntu 22.04コンテナを起動。ログイン。

<code>
# apt install ruby pandoc
# gem install pandoc2review
</code>

incusコンテナでの設定（ホストPCとコンテナでディレクトリを共有）デバイス部分のみ。

<code>
devices:
  impress3:
    path: /home/karma/impress3
    shift: "true"
    source: /home/karma/Documents/impress3
    type: disk
  linux_container_book:
    path: /home/karma/linux_container_book
    readonly: "true"
    shift: "true"
    source: /home/karma/Documents/linux_container_book
    type: disk
</code>

<code>
arma@borg:~$ incus shell pandoc2review
root@pandoc2review:~# ls
root@pandoc2review:~# su - karma
（変換元ディレクトリへ移動）
$ for f in $(ls *.tex)
> do
> pandoc2review $f /path/to/conv/$f
> done
</code>
====== my textlint 環境 ======

<code>
$ docker run -ti --name text-checker -v /home/karma/Documents:/Documents text-checker bash
#（コンテナ内bash）
# cd text-checker
# textlint --rulesdir node_modules/textlint-rule-mistaken-ward-check/lib/ -f pretty-error ../path/to/document.tex
</code>