PukiWiki
安裝
1. 直接執行
1. 下載原始碼
kujakujira.icon官方的osdn似乎不太穩定…？
可從GitHub取得
2. 解壓縮
3. php -S localhost:8080 index.php
注意點
PukiWiki 1.4.7不支援PHP5.4之後的版本
PukiWiki 1.5.0不支援PHP7之後的版本
PukiWiki 1.5.3不支援PHP8之後的版本
PukiWiki 1.5.4不支援PHP8.4？
事前準備
偵錯
移除index.php裡error_reporting(E_ALL);前方的註解
1. 更改pukiwiki.ini.php
1. 管理者的名稱
$modifier = 'anonymous';
2. 管理者的網站
$modifierlink = 'http://pukiwiki.example.com/';
3. 管理者的密碼
$adminpass = '{x-php-md5}!';
可暫時更改為如$adminpass = '{x-php-md5}' . md5('your-pasword');
正式確定使用之後，再改為加密過後的字串
可使用echo -n 'pass' | md5sum快速取得
2. 確認相關資料夾與檔案權限
$ chmod 755 . && chmod 644 *.php && chmod 644 *.lng && chmod 777 ./attach && chmod 777 ./backup && chmod 777 ./cache && chmod 777 ./counter && chmod 777 ./diff && chmod 777 ./wiki && chmod 666 ./wiki/*.txt && chmod 755 ./image && chmod 644 ./image/*.png && chmod 644 ./image/*.gif && chmod 755 ./image/face && chmod 644 ./image/face/*.png && chmod 755 ./lib && chmod 644 ./lib/*.php && chmod 755 ./plugin && chmod 644 ./plugin/*.php && chmod 755 ./skin && chmod 644 ./skin/*.php && chmod 644 ./skin/*.css
3. 確認可正常運作
1. 可編輯頁面
2. 可新增、刪除頁面
3. 可鎖定、解鎖頁面
4. 可操作article或vote等擴充功能
自訂
pukiwiki.ini.php
主頁面名稱
$defaultpage = "フロントページ";
網站名稱
$page_title = "サイト名";
切換語系
$ define('LANG', 'en');
目前只有日文(ja)和英文(en)可選？
調整外觀
版型基本上由pukiwiki.skin.php決定？
社群主題
野生的維基百科
code:default.ini.php(diff)
- define('SKIN_FILE', DATA_HOME . SKIN_DIR . 'pukiwiki.skin.php');
+ define('SKIN_FILE', DATA_HOME . SKIN_DIR . 'monobook/monobook.skin.php');
派生？
後續？
讓搜尋欄於Header常駐
隱藏標題上方的回到頁首
修改[語系代碼].lng.php
$_msg_content_back_to_top = '';
使用者認證
以擴充功能的方式實現
1. BASIC驗證
預設已安裝
啟用編輯限制
pukiwiki.ini.php的$edit_auth更改為1
啟用閱讀限制
pukiwiki.ini.php的$read_auth更改為1
設定登入者帳號
修改pukiwiki.ini.php的$auth_users
格式為'使用者名稱' => '密碼'
此名稱用於下方的$read_auth_pages和$edit_auth_pages
'頁面名稱正規表達式' => '使用者名稱'
2. 外部驗證
code:pukiwiki.ini.php
$auth_type = AUTH_TYPE_EXTERNAL;
$auth_external_login_url_base = './login/extlogin.php';
Google
Twitter
翻譯
新增[語系代碼].lng.php
複製jp.lng.php或en.lng.php後翻譯即可
修改
lib/init.php
code:diff
switch (LANG){
case 'en': define('MB_LANGUAGE', 'English' ); break;
case 'ja': define('MB_LANGUAGE', 'Japanese'); break;
case 'ko': define('MB_LANGUAGE', 'Korean' ); break; //UTF-8 only
// See BugTrack2/13 for all hack about Korean support, //UTF-8 only
// and give us your report! //UTF-8 only
+ case 'zh-tw': define('MB_LANGUAGE', 'Traditional Chinese'); break;
default: die_message('No such language "' . LANG . '"'); break;
}
pukiwiki.ini.php
更改為define('LANG', 'zh-tw');
AdSense
加入至pukiwiki.skin.php的<head>部份
kujakujira.icon
客製化倒是見仁見智，只是都自架了總是會想弄，又是一道工
但覺得PukiWiki的閱讀體驗真的很好
其實也就是基本的側邊欄+內容
到Git Book或HackMD的書籍模式都沒有改變太多
但偏少的裝飾+緊密排版反而操作勞力更少
Wiki系統上也更容易彙整和層疊資料
不過適用情境大概就真的是個人活動者或遊戲之類，比較難用於超過1000頁類型的內容
Scrapbox雖然沒有類似進入點的窗口，但完全可以發展到數十萬頁
與其說孰優孰劣，已經覺得更像是使用方針的不同
2023-07-20 看了一下彩虹社非官方Wiki，總頁面是8217頁的樣子⋯？