pukiwiki1.4/pukiwiki_to_github の履歴(No.1)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• pukiwiki1.4/pukiwiki_to_github へ行く。
  • 1 (2023-12-23 (土) 17:50:00)

---

Pukiwiki→GitHubWikiにした感想（2022年）#

よいこと#

• 導入が非常に楽。初期費用も維持費も無料。
• 管理者を増やすのが楽。オーナーと音信不通になってもコミュニティを継続できる。（と思う）
  • 誰でも編集できるwikiにしたい場合 Settings > Restrict editing to collaborators only のチェックを外す
• 検索すれば大抵のことは解決する
  • マニュアルはある
  • GitHub 上での執筆とフォーマットについて
  • GitHub Wiki のページ内リンクについて
• 【重要】セキュリティ対応が法人サイトレベルかそれ以上。HTTPヘッダーセキュリティチェッカー で https://github.com/nemusg/nemusg.com/wiki/ などをチェックしてみてもらえると。

微妙なところ#

• Pukiwikiで便利だったプラグインが使えない。
  • 例えばnumber.inc.phpはテーブル内で自動で連番を付けてくれるもので、PeercastRecordなどではこれがあるとないでは更新の手間が大きく違う。テーブルを使うことを諦めて番号付きリストで代用する手もあるが……。
• 当然だけど記法が異なる。でもPukiwiki記法もいい加減古いのでこの際Markdownに慣れるいい機会だと思う
  • 下記を参考に　MultiReplace を使って置換すると楽そう
    • PukiWiki の文書を Markdown に変換するワンライナー
    • PukiWiki のページファイル名の変換と、Pukiwiki 記法から Markdown 記法へ変換する雑なスクリプト
• 画像の添付は少し敷居が高い アップデートで添付が簡単になりました 参考。消すときはどうするんだろう？
  • ブラウザからでなくクローンしてコミット＆プッシュが必要
    • 参考 : GitHubのWikiに画像を貼付ける際にちょっと迷ったのでメモ。
• GoogleAnalyticsとかAdsenseとかは当然貼れないので収益化はできない。footerとかsidebarにアフィリエイトリンクとかは貼ってる人はいるのかもしれないが。
  • アクセス数は Insights > Traffic で確認可能
    • 参考 : Add Google Analytics to Github wiki pages - Stack Overflow
• ページ名に利用しないほうがいい記号がある
  • \ / : * ? " < > | がページ名に利用できてしまうが、これを行うとWindowsなどでプルしたときに認識できなくなる。
  • 参考 : ウィキのファイル名について
• 文字色を変えたり、ちょっとした装飾が難しい
  • GitHubのWikiでは文字の色を変えることができなかった

効率的に移行するには#

• Pukiwikiのwikiフォルダのファイルをそのまま移行するのが早そう
• ファイル名 46726F6E7450616765.txt（実際のページ名は FrontPage ） の変換はツールで対応可能
  • Web上で変換 pukiwikiファイル名逆変換ツール - インターネットIT技術Tips
  • 【おすすめ】ソフトウェアで一括変換 PukiWikiファイル名変換の詳細情報 : Vector
  • 拡張子は .txt から .md にする必要がある。（例）GitHubWiki のトップページは Home.md
    • テキスト型リネームツールの詳細情報 : Vector

正規表現まわり#

• 正規表現チェッカーを見ながらMultiReplace用の記述を作った
  • 区切り文字 / の場合です。
  • テーブルは手で直す必要がありそう
  • 行頭の半角スペースで「整形済みテキスト（コードブロック）」としている場合を置き換えるのは無理だと思う...

\[#[0-9a-z]+]/
\*\*\*/###
\*\*/##
\*/#
\#title\(.+\)/
-- +/--
^---/    - 
^--/  - 
\|~/|
\[\[/[
:http/](http
\]\]/)
&br;/<br>
# コメント/
#pcomment/
BGCOLOR\(#.+\):/
\|>/|
\(\(/`
\)\)/`
''/`
#geshi\([a-z,]+\){{/```

#contents/ }}

CSSを書いてフォントサイズを調整したいが無理そう#

<style>
.markdown-body {
    font-size: 14px;
}
</style>