nDiki : 組織内公開ワーキングノートサイト

2022年2月24日 (木)

組織内公開ワーキングノートサイト整備に合わせてノート構成と配置を考え直す

MkDocs + GitHub Enterprise Server の GitHub Pages で組織内公開ワーキングノートサイトをいい感じにできそうになってきた。

仕事用 Web ブラウザのスタートページ用ノート Things to Keep in Mind at Work ノートは MkDocs サイトの方に移すのが良さそう。

合わせて Things to Keep in Mind (at Work じゃない方) ノートや Top of Mind ノートも整理するかな。「最近考えていること」にフォーカスした Top of Mind ノートとは別に「今していること」を書き出しておく /now page も追加したくなってきた。

[ permalink ]
[ 2月24日全て ]

2022年3月22日 (火)

Logseq でワーキングノートを GitHub Pages にデプロイし公開する

「公開で作業する」というコンセプトで Markdown で書いているノートを先月から MkDocs + GitHub Enterprise Server (以下 GHE) の GitHub Pages で公開してみている(記事)。

一昨日から使い始めたアウトライナー Logseq には graph (ページ群) を静的サイトとしてエクスポートする機能が標準でついている。思考中のメモを公開するのにうってつけそうだ。

MkDocs を使ったドキュメントベースの社内ノートサイトとは別に、アウトラインベースの社内ノートサイトを作ってみた。

手順1: ghp-import をインストール

MkDocs が GitHub Pages へのデプロイで使っている ghp-import をインストールする 

 $ pip3 install ghp-import

MkDocs をインストールしていればすでに入っている。

手順2: GHE でリポジトリを作成

GHE 上で graph リポジトリを作成する。プライベートでも OK。

手順3: Git リポジトリをローカルに clone する

Git リポジトリを clone したあと、Logseq graph をエクスポートするディレクトリとして site/ を作っておく。 

 $ git clone git@example.com:Naney/graph.git
 $ cd graph
 $ git config user.name 'WATANABE Yoshimasa'
 $ git config user.email naney@example.com
 $ mkdir site

手順4: Logseq で graph をエクスポートする

まずエクスポートするページ毎に [Make it public for publishing] しておくか、設定で [All pages public when publishing] をオンにしておく。

Logseq のメニューから [Export graph] を選び、 Export public pages を指定する。エクスポート先を選択するダイアログで前の手順で作成した site ディレクトリを選び、エクスポートする。

手順5: GitHub Pages にデプロイする

Git リポジトリディレクトリの中で以下を実行しデプロイする。 

 $ ghp-import --push --force --no-jekyll site

[ 組織内公開ワーキングノートサイト ] [ 公開で作業する ]

[ permalink ]
[ 3月22日全て ]

2022年3月23日 (水)

Logseq のジャーナルページ機能が心地よい

Logseq + GitHub Pages で昨日作成した組織内公開ワーキングノートサイト向け Logseq graph で実際にいろいろ書き始めてみた。

ジャーナルページに思い浮かんだことをスレッド的にダンプする

ジャーナル機能を使うかどうか迷ったけど使ってみている。 inbox として取りあえずさっと書けるのに加えて、関連して思い浮かんだことを子リストとしてスレッド的に書き足していけるのが心地よい。inbox として理想的だ。Tweet せずにここにダンプしておけば十分ではと思えてきた。

MkDocs + GitHub Page のページを移す

Markdown ファイルを順次移しながらチェック。

logseq-mermaid-plugin を使えば Logseq でも mermaid の図を入れられるが mermaid.ink という外部サイトでレンダリングさせる方式なのでそのまま使えない。fenced code block ではなく独自記法で囲む必要があるのもマイナスポイント。

セル内改行している表が Logseq ではうまく表示されなかったのでこれも移すのをいったん保留した。

Obsidian vault の中に Logseq graph を置くのをやめる

Logseq のスタイルで頻繁に graph を更新していくには Obsidian vault の中に置いておかない方がやはり良いな。組織内公開ワーキングノートサイト向け graph は外に出した。

ただそうすると Logseq のジャーナルと Obsidian のデイリーノートで2重管理が発生する。Logseq の backlink を活用するためには Logseq に書いておきたいし、後で参照するためのアーカイブとして Obsidian にも書いておきたい。 Logseq から Obsidian に転記したら 📋 でマークしてみたけれど、うまくいかない気がする。

Logseq でエクスポートした静的サイトは Google 検索エンジンにほとんどインデックスされない

公開ノートサイトにも Logseq を使ってみるのどうかと思ったけれど、 index.html にページデータを書き出した SPA になるのでページ数が増えた時に読み込みが遅くならないかなど懸念を感じた。 https://logseq.github.io/ はトップページしか Google 検索でヒットしていなさそうだし SEO も不利そうだ。公開サイトで使うメリットは少ないな。

[ permalink ]
[ 3月23日全て ]

2022年6月7日 (火)

Obsidian Publish サイトと MkDocs サイト

一般的な話のノートは Obsidian Publish サイトで全体公開していて、組織固有の話のノートは Obsidian + MkDocs を使った組織内公開ワーキングノートサイトで限定公開している。

限定公開ノートから全体公開ノートへのリンクをつけるのがいささか面倒。さしあたって roamlinks MkDocs プラグイン と md-condition Markdown エクステンションを使って 

 [Naney](https://notes.naney.org/Notes/Naney)

 <!--- #if OBSIDIAN -->
 [[Naney]]
 <!--- #endif -->

とリンクしている。

ああ、この限定公開から全体公開にリンクする機能を欲するの、20年弱前から変わらないなあ。WikiEngine を自作していた時は InterWikiLink を実装していたんだっけ。

[ permalink ]
[ 6月7日全て ]

2022年11月15日 (火)

個人の組織内公開ワーキングノートサイト上で参照資料となったノート

組織内で「公開で作業する」というコンセプトで2月から MkDocs + GitHub Enterprise Server の GitHub Pages で組織内公開ワーキングノートサイトを作って使っている。

Markdown 形式で書いている作業中のノートを気軽に共有できるようになったのはやはり良かったかな。

一方9カ月続ける中で他から何度も参照されるような寿命の長いノートが出てきて、ノートへのたどり着きにくさが課題になってきている気はする。過去にシェアした URL を見つけ出して再閲覧するために記憶に頼るところが大きすぎるなと。

参照資料になったノートはきちんと組織の情報共有ツールの方に移しておくべきというのが正論でありつつ、ほとんどそのままにしちゃうんだよね。

[ permalink ]
[ 11月15日全て ]

2022年11月16日 (水)

今日のさえずり: プログラミングの書籍で「おまじない」という説明が出てきたらそこでそっ閉じ

  • 08:41 NTTドコモ代々木ビル好き。 #photography RICOH GR III #GR #GRIII #GR3 https://t.co/GwXeqAemWM
  • 11:51 なんか寒いので日の当たる席で日向ぼっこしてる。
  • 11:52 Naney の日記: 個人の組織内公開ワーキングノートサイト上で参照資料となったノート https://www.naney.org/...
  • 13:57 Google Pixel Buds Pro のイヤーチップを「小」にしたらどうかなと試してみた。アプリで「イヤーチップのフィット感の確認」をした結果、アクティブ ノイズ キャンセリング的には「中」の方が良いことが分かった。 https://t.co/yOcF88WAUd
  • 14:00 あと、Google Pixel Buds Pro だと右の方が密閉性が悪くなりがちだということが分かった。
  • 15:07 プログラミングの書籍で「おまじない」という説明が出てきたらそこでそっ閉じするということ若い時に体得した。
  • 15:08 今なら本当に「おまじない」で動くシステムがあるのかもしれない。
  • 18:06 HiveQL クエリを用意して新規チャートを作ったので満足している。
  • 19:50 Google Pixel Buds Pro のイヤーチップの筒、やはり目っぽい。
  • 21:02 もしかしたら昼間に試した部屋より空調音がしない部屋で試したら「小」でもいけるかな? と思って試してみたが、やはり同じぐらい右が NG になるので「中」にした。
  • 21:07 あと、右の方、ぎゅっと押し込めば改善するわけでもないことが分かった。 右は押し込みすぎない方が合格になりやすい。
  • 24:02 『機動戦士ガンダム 水星の魔女』第6話を観て追いついた。あと2つおまけがあるみたい。
  • 24:13 突然 POV-Ray を思い出した。
  • 25:15 2022年11月16日 (水) したこと - Google Pixel Buds Pro のイヤーチップ各サイズを試す - HiveQL クエリを用意して新規チャートを作る - 『機動戦士ガンダム 水星の魔女』第6話を観る
[ permalink ]
[ 11月16日全て ]

2023年2月2日 (木)

MkDocs + Roamlinks プラグインを使ったサイトのナビゲーション

Obsidian + MkDocs + MkDocs Roamlinks Plugin を使った組織内公開ワーキングノートサイトについて、やっぱりメンテナンスが億劫になった。ナビゲーションの中身をばっさり消すことにした。

ページ間の移動はノート内のリンクと検索ベースで。バックリンクをつけてくれる良いプラグインがあればいいんだけれどな。

[ permalink ]
[ 2月2日全て ]

2023年2月22日 (水)

mkdocs-backlinks うまく使えず【日記】

髪伸びてきたので来週で床屋の予約をした。

MkDocs + Roamlinks Plugin で静的サイト生成している組織内公開ワーキングノートサイトでやっぱりバックリンクが欲しいなと思って mkdocs-backlinks v0.9.1 試してみた。

がバックリンクを出力させられず。ソースコードを読んでみたがうまく動かない理由は分からずじまい。

[ permalink ]
[ 2月22日全て ]

2023年5月9日 (火)

今日のさえずり: 高坂駅近くの「しるや」は閉店済みか。あのボリュームと注文してからの待ち時間の長さが懐かしい。

[ permalink ]
[ 5月9日全て ]

2023年5月10日 (水)

組織内で「公開で作業する」というコンセプトの実験を終了する

MkDocs + GitHub Pages で組織内公開ワーキングノートサイトを1年ちょっと続けてきたけれど最近ちょっと保守熱意が下がってきている。

組織内で「公開で作業する」というコンセプトの実験は一度終了することにする。

ふりかえり

[ permalink ]

今日のさえずり: 今までは「既読にしない」ことで inbox 扱いにしてた

[ permalink ]
[ 5月10日全て ]
Naney の Web 日記 nDiki について・月別インデックス

About

Naney Naneymx

Naney (なにい) です。株式会社MIXIで SNS 事業の部長をしています。

※本サイトの内容は個人的見解であり所属組織とは関係ありません。

Process Time: 0.023675s / load averages: 0.25, 0.32, 0.32