単一 HTML ファイル 60k～64k バイトの軽量な Wiki システム Feather Wiki（フェザーウィキ）についてまとめています。

2022年5月に初公開のバージョン 1.0.1 が公開されています。

運営者が Feather Wiki で公開しているのは次があります。

• 🎈 BALLOON | FU-SEN 📖 Feather Wiki - 🎈 Neocities で公開、カスタム CSS、ヒントなど
• 🎈 Feather Wiki 日本語サンプル - 🎈 Cloudflare Pages＋🎈 EU.org で公開\

🎈 Feather Wiki | 🎈 BALLOON | FU-SEN - English information

目次

公式サイト

•  Feather Wiki - 公式サイト
•  Alamantus/FeatherWiki | Cordberg - ソース
  • Issues - 報告
•  Alamantus/FeatherWiki | GitHub - ソース（ミラー）

ソースのメイン公開は 🎈 Codeberg になっています。
GitHub はミラーで Issues もありますが、報告は Cordberg 側推奨です。

.html ファイルをダウンロードする

公式サイトから FeatherWiki_●●.html をダウンロードし、任意の場所に保存します。

  Download | Feather Wiki

2024年12月より日本語表示が追加されています。
Japanese (ja_JP) FeatherWiki_●●_ja-JP.html です。
ja-JP などが付いてない html ファイルは英語になります。

このダウンロードした FeatherWiki_●●.html をブラウザで開いて下さい。

1.7.1 まではいくつかのファイルが存在していましたが、
1.8.0 より１ファイルで配布されています。

簡単な使い方

サイドバー 新規ページ ・ New Page を選ぶと
「新しいページタイトル」・「New Page Title」の
テキストボックスが表示されるので、タイトルを入力します。
作成 ・ Create で「ページを編集」・「Edit Page」画面になります。
本文以外は次のとおりです。

この設定は  で変更できます。

Wiki 設定 ・ Wiki Settings は Wiki 全体の設定を行えます。

Import & Overwrite with Other Feather Wiki file は
 アップグレード や Wiki の種類変更に使用できます。

「埋め込み画像」・「Existing Images」で Wiki 内でアップロードした画像の管理ができます。

ページを保存・編集・削除した後、サイドバーの Wiki を保存 ・ Save Wiki で
反映された .html ファイルの保存になります。
必要であれば、.html ファイルの名前を変更して構いません。
また、この .html ファイルをサーバへアップロードして公開できます。

Tiddlyhost で使用する

 Tiddlyhost

Tiddlyhost は 🎈 TiddlyWiki 向けのホスティングサービスですが、
Feather Wiki にも対応しています。Tiddlyhost へ保存できる専用の Feather Wiki です。

サーバは アメリカ Dreamhost の VPS を使っているようです。
Wiki の表示で若干待たされますが、
まともに使うと Google などの検索結果は良い状態にできるかもしれません。

Sign up を選択してアカウントを作成します。

※ 一つのアカウントで複数の Wiki を作成できる仕組みになっています。

サイト一覧になります。なにもないので Create site で Wiki を作成していきます。
（「Claim Tiddlyspot site」は旧システム Tiddlyspot からの移行です）

下の Show advanced settings を選択し、「Advanced settings」を表示し、
「TiddlyWiki version」で FeatherWiki を選択します。

Your sites で一覧表示されます。
サブドメイン.tiddlyhost.com を押すと、Wiki の画面になります。
右に表示されているアイコンは次のとおりです。

Download の .html ファイルは他サーバへ公開できます。
他のサービスへの移行や独自ドメインを使用した公開に使用できます。
逆に .html ファイルを Upload して Tiddlyhost へ移行する事もできます。

「Save Wiki」の代わりに Save Wiki to Server と Save Wiki Locally と表示されます。
Save Wiki to Server で Tiddlyhost の .html ファイルを更新します。

ファイルサイズ

Git・Web サービスにより、1 ファイルの容量制限が存在します。
サービスにより 1 ファイル 10MB～100MB 位です。

画像ファイルなどを Wiki 内に含める事ができますが、（インポート）
ファイルサイズが大きくなるので、Wiki 外で個別にアップロードし、
URL 形式で表示するようにするのが一つの回避手段です。

また、種類・パートに応じて異なる .html ファイルに分割し、
ファイルサイズを小さくする回避手段もあります。

アップグレード

英語版から日本語版へ移行するのも同じ手順で行えます。

  Upgrading | Feather Wiki

Tiddlyhost を使用している場合は Download を用いて、
.html ファイルをダウンロードして下さい。

新しいバージョンの .html ファイルをダウンロード・保存します。

  Downloads | Feather Wiki

新しいバージョンの .html ファイルをブラウザで開きます。
サイドバー Wiki 設定 ・ Wiki Settings より下部にある
他の Feather Wiki ファイルをインポート・上書きする ・
Import & Overwrite with Other Feather Wiki file を選択します。
ここでこれまで使用していた Feather Wiki の .html を選択します。
これで Wiki の内容が反映されますので、Wiki 設定 ・ Save Wiki をして保存します。

Tiddlyhost は Upload でアップグレードを行った .html ファイルを反映して下さい。

Q&A

TiddlyWiki とは何が異なるのですか？

TiddlyWiki はデフォルト状態で 2MB 以上ありますが、
Feather Wiki のデフォルト状態は 0.06MB です。

そのため、画像は WYSIWYG エディタ のアイコンのみで、
基本的にテキスト表記になっていたり、ページ構成も少なくなっています。

TiddlyWiki は 1 画面に複数の Tiddler を表示できますが、
Feather Wiki は普通に投稿のページ単位です。

Markdown を使っていますが、機能しない文法があります。

Feather Wiki の 🎈 Markdown パーサーは 1.4.1 より MD.js を採用しています。

 thysultan/md.js | GitHub

1.4.0 までは Snarkdown を採用していましたが、解釈されない事があったため、
またサイズを更に小さくできるよう、MD.js に切り替えられています。

 developit/snarkdown | GitHub

いずれもサイズの小さい Markdown パーサーのため、完全に構文を対応していません。
期待する表示にならない場合は HTML タグに変更するのが確実です。

逆に Markdown で存在していない内部リンク [[ページ]] および
[[名前|ページ]] が使用できます。
画像をアップロードした時も URL の代わりに独自のコードを使用します。

外部リンクを入れると新しいタグで開いてしまいます。

Feather Wiki の仕様により、<a href=" から始まるタグに
target="_blank" rel="noopener noreferrer を付与します。
これにより外部リンクは新しいタブ（新しいウインドウ）で開くようになります。

<a href="URL">名前</a>

これは Markdown も含まれます。

[名前](URL)

これを回避したい場合、 <a href=" でなければ付与されないので

<a href='URL'>名前</a>

または

<a href=URL>名前</a>

とすると新しいタブ（ウインドウ）で開く対象から外れます。

見出しで日本語を使うと ＃ のリンクが正しく動作しません

1.3.1 までは日本語は - に変換されてしまいます。
したがって日本語 5 文字の見出しは URL の末尾が #----- になってしまいます。

 Non-ASCII languages cause some problems #67 | Codeberg Alamantus/FeatherWiki Issues

1.4.2 までにこの問題が対処され、
日本語の見出しでも URL をそのまま出力するようになっています。

日本語表示にできますか？

2024年5月の 1.8.0 より言語対応が追加され、
2024年12月より日本語が追加されています。
これによりメニューなどの表示が日本語で使用できるようになりました。

  Download | Feather Wiki

改めてダウンロードが必要です。 ja-JP を含むファイルをダウンロードします。
その後  アップグレード 手順で英語版から移行して下さい。

Google などの検索結果に表示されますか？

 Google 検索 - site:feather.wiki

公式サイトそのものが Feather Wiki で構築されていますが、
各ページを含めて、Google の検索結果に収集されています。
しかも、公式サイトは「Include Static HTML」を使用していません。
つまり Googlebot は JSON データで入っていても正しく収集しますし、
?page=●● 付の URL も一つの検索結果として反映します。

他の検索エンジンクローラは JSON データまで収取していない可能性があるので、
「Include Static HTML」を 有効 にしても良いかもしれません。

1.5 より Wiki Settings 内に「Custom Head」が追加されましたので、
こちらに必要なヘッダーを入れる事で期待する検索結果で表示され、
SNS などでも効果が得られるよういなりました。

任意の meta タグなどを含める事ができますか？

1.5.0 より Wiki Settings に「Custom Head」が含まれ、
<head> 内のタグなどを容易に記載できるようになっています。
アナリティクスやサイト確認用の <meta> タグをここで含められます。
🎈 Open Graph protocol と Twitter カード も追加できます。

<link rel="canonical" href="https://example.net.eu.org/">
<meta name="theme-color" content="#eeeeee">
<link rel="icon" href="https://example.net.eu.org/favicon.ico">
<link rel="icon" type="image/png" href="https://example.net.eu.org/favicon.png">
<link rel="icon" type="image/png" href="https://example.net.eu.org/favicon.png">
<link rel="apple-touch-icon" sizes="256x256" href="https://example.net.eu.org/apple-touch-icon.png">
<meta name="theme-color" content="#ddeeff">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="タイトル">
<meta name="twitter:description" content="説明">
<meta name="twitter:image" content="https://example.net.eu.org/ogp.png">
<meta property="og:type" content="website">
<meta property="og:title" content="タイトル">
<meta property="og:description" content="説明">
<meta property="og:site_name" content="サイト名">
<meta property="og:image" content="https://example.net.eu.org/ogp.png">

Publish を有効にしてファイルを保存してしまいました。編集する事はできますか？

.html ファイルを Web ブラウザで参照した時、
URL 末尾に ?page=s を付けて参照して下さい。
「Wiki Settings」画面になると共に編集関連のボタンも表示されます。
この状態で「Publish」の を外して Update する事で、
編集可能な状態にできます。

現在のバージョンを知る方法は？

Web ブラウザで表示している時、右下の「Powered by Feather Wiki」のうち
Feather Wiki のところにカーソルを当てて下さい。
Version: Dove_1.3.1 などと表示されます。

またはソースを見ます。Minify が適用されているので見にくいですが、
Ctrl+F で検索フォームを表示し、 name=version と入力して下さい。
次のように meta タグが存在してバージョンが記載されています。

<meta name=version content=Chickadee_1.3.1>

別のバージョンへ変更したいのですが？

 アップグレード と同じ方法を用いて、
別のバージョンへ移行する事ができます。

英語版から日本語版へに移行も同様に  アップグレード です。

Neocities で公開するとスクリーンショット表示で背景が真っ白になる事があります。

Feather Wiki が JS でデザインを展開する前に
Neocities のキャプチャが発生してしまう事があります。
背景が白い表示は Static HTML の出力なので、
「Include Static HTML」を 有効 にすれば
背景が真っ白でもある程度のテキストは出力された状態になります。

 Neocities screenshots may result in static HTML (black text and white background, no CSS). #62 | Codeberg Alamantus/FeatherWiki Issues

ページ運営者が報告していました。1.4.0 でこの問題が解決されています。

この issues で表示されているプラグインを適用していた場合は
1.4 系では不要になっているので、削除して下さい。