commit(auto)
This commit is contained in:
parent
c77cdf7b25
commit
36b154f8e3
2 changed files with 17 additions and 19 deletions
|
@ -1,40 +1,42 @@
|
|||
# 20240122201309 全体的な書き方の方針
|
||||
#meta
|
||||
# 000000000002 全体的な書き方の方針
|
||||
#meta #zettelkasten #index #moc #notes #memo
|
||||
|
||||
### 内容
|
||||
|
||||
書いてある内容は、できれば10年後も情報に意味があるように注意。たとえば、URLなどをリンクするだけだと、そのサイトが消滅した場合に何もわからなくなってしまう。本の場合も捨てたり、紛失してしまうことがあるかもしれない。引用は最低限、コピペでよいのでテキストで有用と(少なくとも書いた時には)思ったことを明示するようにする。そのノート単体で読めば、内容が理解できるようになっているのが望ましい。
|
||||
書いてある内容は、できれば10年後も情報に意味があるように注意。たとえば、URLなどをリンクするだけだと、そのサイトが消滅した場合に何もわからなくなってしまう。本の場合も捨てたり、紛失してしまうことがあるかもしれない。引用は最低限、コピペでも良いので有用と(少なくとも書いた時には)思ったことを明示するようにする。そのノート単体で読めば、内容が理解できるようになっているのが望ましい。望ましいだけで<実際にできているかは不明。
|
||||
|
||||
### フォルダ構成
|
||||
|
||||
完全フラット。階層は作らない。どのようにフォルダで分類しても完全では無いし、フォルダ内のアイテムを移動した場合、画像などのリソースが見つからなくなってしまうことなどがある。という苦労を20年くらいして、もう無理ということになった。私にはフラットにする以上に、スケールできる上、ロバストなものは作れなかった。
|
||||
基本的に完全フラット。階層は作らない。どのようにフォルダで分類しても完全では無いし、フォルダ内のアイテムを移動した場合、画像などのリソースが見つからなくなってしまうことなど、これまで数多くのフォルダに関わる苦労があった。20年くらい色々試しして、もう無理ということになった。私にはフラットにする以上に、スケーラブルで、ロバストなものは作れなかった。
|
||||
|
||||
cf. [[000000000010 フォルダとその使い方]]
|
||||
|
||||
### ファイル形式
|
||||
|
||||
plain textとして人間が読むことができれば、どのような種類でもかまわない。ただのtxtでも、orgでも、markdownでも、adocでもよい。200203時点ではmarkdownが、面倒さと記述のバランスが取れていると思っているのでメインで使用している。
|
||||
plain textとして人間が読むことができれば、どのような種類でもかまわない。ただのtxtでも、orgでも、markdownでも、adocでもよい。202203時点ではmarkdownが、面倒さと記述のバランスが取れていると思っているのでメインで使用している。
|
||||
|
||||
リンク的なものについては、wikilink記法を使用している。つまり `[[こういうやつ]]`。
|
||||
色々なソフトがこのリンクをフォルダ全体から探してきてくれて、破綻することはなさそうだと思っているが、将来問題になってしまう可能性は0ではない。ことはちょっと気になっている。
|
||||
色々なソフトがこのリンクをフォルダ全体から探してきてくれて、破綻することはなさそうだと思っているが、将来問題になってしまう可能性は0ではない。
|
||||
|
||||
### ファイル名の規則
|
||||
|
||||
wikilinkを使う都合上、全部のファイルがユニークなファイル名を持っている必要がある。
|
||||
そのため、ファイル名にはタイムスタンプを先頭に追加する。 YYYYMMDDHHmmss形式。 これは作成したタイミングのタイムスタンプで、中身を変更してもファイル名は変えない。
|
||||
そのため、ファイル名にはタイムスタンプを先頭に追加する。 YYYYMMDDHHmmss形式。 これは作成したタイミングのタイムスタンプで、中身を変更してもファイル名のタイムスタンプは変えない。
|
||||
|
||||
例: `20240109190207 hogefuga.md`
|
||||
|
||||
### ファイル内容の規則
|
||||
|
||||
専用ファイルなど一部を除き、metadata/front matterのような、システム依存の内容は書かない。 tagを `#tag` 形式で書くことはOK。
|
||||
専用ファイルなど一部を除き、metadata/front matterのような、システム依存の内容は書かない。 唯一、tagを `#tag` 形式で書くことはOK。
|
||||
それ以外は、上述の各マークアップを使って書く。
|
||||
画像その他の非テキストのリソースは assets以下にフラットに保存する。
|
||||
画像その他の非テキストのリソースは assets以下にフラットに保存する。公開できるものはassets/publicに移動する。
|
||||
|
||||
1行目の最初のヘッディングはファイル名と同じにする。
|
||||
その直下にタグを列挙。
|
||||
|
||||
ざっくり、ファイルの内容は以下のようになる。
|
||||
|
||||
`memo/20240122201909 ものすごいことを発見.md` というファイル名で
|
||||
```md
|
||||
# 20240122201909 ものすごいことを発見
|
||||
#yatta #sugoi
|
||||
|
@ -47,8 +49,5 @@ wikilinkを使う都合上、全部のファイルがユニークなファイル
|
|||
よかったね。
|
||||
```
|
||||
|
||||
画像のテスト
|
||||
|
||||
![[スクリーンショット 2024-01-22 200139.png | 500]]
|
||||
|
||||
[[000000000003 日々のノート追加の流れ]]
|
|
@ -7,18 +7,17 @@ kazboのpublic notesにようこそ。
|
|||
|
||||
## これは何?
|
||||
|
||||
kazboことKaz(uki) Saita/斉田一樹の書きちらかしたメモが堆積したものから、ある程度有用かもしれない内容を、publicに公開しようとしているものです。
|
||||
kazboことkaz(uki) Saita/斉田一樹の書きちらかしたメモが堆積したものから、ある程度有用かもしれない内容を、publicに公開しようとしているものです。
|
||||
|
||||
### 方針のようなもの
|
||||
- [[000000000002 全体的な書き方の方針|全体的な書き方の方針]]
|
||||
- [[000000000002 メモ ノートの書き方|メモ ノートの書き方]]
|
||||
|
||||
## disclaimer
|
||||
ここに書かれている内容は、できるだけ有用で普遍性があるように努力はしていますが、時期や状況により、たまたまうまくいったことなども書かれています。やってみてうまくいかないことはありえます。
|
||||
|
||||
できるかぎりリンク切れが無いように整備していますが、時々無い記事もあるかもしれません。
|
||||
自動更新されるかしら
|
||||
|
||||
[[20240219173704 sandbox|sandbox]]
|
||||
### 方針のようなもの
|
||||
- [[20240122201309 全体的な書き方の方針|全体的な書き方の方針]]
|
||||
- [[000000000002 メモ ノートの書き方|メモ ノートの書き方]]
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
Loading…
Reference in a new issue