両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン |
linux:dokuwiki [2022/10/08 04:10] – [システムの PHP バージョンをアップデートする] ともやん | linux:dokuwiki [2025/03/28 12:27] (現在) – [DokuWiki プラグイン開発 (Devel)] ともやん |
---|
本家: [[https://www.dokuwiki.org/dokuwiki|dokuwiki [DokuWiki]]]\\ | 本家: [[https://www.dokuwiki.org/dokuwiki|dokuwiki [DokuWiki]]]\\ |
ソースコード: [[https://github.com/splitbrain/dokuwiki|splitbrain/dokuwiki: The DokuWiki Open Source Wiki Engine]]\\ | ソースコード: [[https://github.com/splitbrain/dokuwiki|splitbrain/dokuwiki: The DokuWiki Open Source Wiki Engine]]\\ |
| |
| ===== 更新前に必ず確認‼️ ===== |
| [[https://www.dokuwiki.org/changes|]] ([[https://www-dokuwiki-org.translate.goog/changes?_x_tr_sl=en&_x_tr_tl=ja&_x_tr_hl=ja&_x_tr_pto=sc|翻訳]])\\ |
| |
| [[https://www.dokuwiki.org/changes#release_2023-04-04b_jack_jackrum|Release 2023-04-04b “Jack Jackrum”]]\\ |
| * The options to embed HTML and PHP have been completely removed for security reasons :!: |
| * HTMLとPHPを埋め込むオプションは、セキュリティ上の理由で完全に削除されました :!: |
| * HTMLとPHPを埋め込むには [[https://www.dokuwiki.org/plugin:htmlok|htmlok Plugin]] で対応 |
| |
===== 技術資料 ===== | ===== 技術資料 ===== |
$ cp dokuwiki/conf/mime.conf dokuwiki/conf/mime.conf.bak | $ cp dokuwiki/conf/mime.conf dokuwiki/conf/mime.conf.bak |
$ tar jcvf dokuwiki_20220804_1.tar.bz2 dokuwiki/ | $ tar jcvf dokuwiki_20220804_1.tar.bz2 dokuwiki/ |
</pre></html></WRAP> | |
<WRAP color_result><html><pre> | |
</pre></html></WRAP> | </pre></html></WRAP> |
</WRAP> | </WRAP> |
| |
**リポジトリ設定** (Remi リポジトリを利用する設定が必要)\\ | **リポジトリ設定** (Remi リポジトリを利用する設定が必要)\\ |
[[linux:fedora_rpmfusion|Fedora で RPM Fusion, Remi リポジトリを利用する]]\\ | [[linux:fedora:rpmfusion|Fedora で RPM Fusion, Remi リポジトリを利用する]]\\ |
| |
<WRAP color_term> | <WRAP color_term> |
[[git>splitbrain/dokuwiki/issues?q=is:issue is:open label:"PHP 8"|ラベル: PHP 8 で開いている Issues · splitbrain/dokuwiki]]\\ | [[git>splitbrain/dokuwiki/issues?q=is:issue is:open label:"PHP 8"|ラベル: PHP 8 で開いている Issues · splitbrain/dokuwiki]]\\ |
| |
===== Plugin ===== | ===== DokuWiki プラグイン (Plugin) ===== |
[[:linux:dokuwiki:mathjax_plugin|MathJax Plugin]]\\ | [[:linux:dokuwiki:mathjax_plugin|MathJax Plugin]]\\ |
[[:linux:dokuwiki:mathpublish_plugin|mathpublish Plugin]]\\ | [[:linux:dokuwiki:mathpublish_plugin|mathpublish Plugin]]\\ |
[[:linux:dokuwiki:codeMirror_plugin|CodeMirror Plugin]]\\ | [[:linux:dokuwiki:codeMirror_plugin|CodeMirror Plugin]]\\ |
| |
| ==== DokuFreaks ==== |
| [[https://github.com/dokufreaks|{{https://avatars.githubusercontent.com/u/86480?&.png?100x100&recache|DokuFreaks }}]] |
| [[git>dokufreaks|DokuFreaks]] GitHub 組織は、元の作成者によってほとんど放棄されたプラグインが **最小限** 維持される場所です。これは、言語の更新が適用され、簡単なプル リクエストが適用され、プラグインが通常、最近の DokuWiki リリースで動作する状態になる必要があることを意味します。 |
| |
| 一方、これは、そこにリストされているプラグインが**積極的に開発されていない**ことを意味します。機能リクエストはほとんど無視され、マージに大きな労力が必要なプル リクエストはおそらく永久に無視されるでしょう。 |
| [[https://www.dokuwiki.org/dokufreaks|dokufreaks [DokuWiki]] より🤔\\ |
| ===== DokuWiki プラグイン開発 (Devel) ===== |
| [[linux:dokuwiki:dokuWiki_plugin_development|DokuWiki プラグイン開発 (Devel)]]\\ |
===== DokuWiki テーマ カスタマイズ ===== | ===== DokuWiki テーマ カスタマイズ ===== |
| |
$ cd dokuwiki/lib/tpl/ | $ cd dokuwiki/lib/tpl/ |
$ cp -r bootstrap3 bs3tomoyannet | $ cp -r bootstrap3 bs3tomoyannet |
</pre></html></WRAP> | |
<WRAP color_result><html><pre> | |
</pre></html></WRAP> | </pre></html></WRAP> |
</WRAP> | </WRAP> |
$ cd bs3tomoyannet | $ cd bs3tomoyannet |
$ nano template.info.txt | $ nano template.info.txt |
</pre></html></WRAP> | |
<WRAP color_result><html><pre> | |
</pre></html></WRAP> | </pre></html></WRAP> |
</WRAP> | </WRAP> |
<WRAP color_command><html><pre> | <WRAP color_command><html><pre> |
$cp template_dir/css/custom.less bs3tomoyannet/css/custom.less | $cp template_dir/css/custom.less bs3tomoyannet/css/custom.less |
</pre></html></WRAP> | |
<WRAP color_result><html><pre> | |
</pre></html></WRAP> | </pre></html></WRAP> |
</WRAP> | </WRAP> |
<WRAP color_command><html><pre> | <WRAP color_command><html><pre> |
$ nano style.ini | $ nano style.ini |
</pre></html></WRAP> | |
<WRAP color_result><html><pre> | |
</pre></html></WRAP> | </pre></html></WRAP> |
</WRAP> | </WRAP> |
1546495335 127.0.0.1 E linux:dokuwiki tomoyan [geeklogのDokuWiki Plugi(注意: 以下>は古い情報です)] 1 | 1546495335 127.0.0.1 E linux:dokuwiki tomoyan [geeklogのDokuWiki Plugi(注意: 以下>は古い情報です)] 1 |
</code> | </code> |
| </WRAP> |
| |
| ==== サーバーキャッシュのパージ ==== |
| 公式: [[https://www.dokuwiki.org/caching|caching [DokuWiki]]] [[gtr>https://www.dokuwiki.org/caching|翻訳]]\\ |
| <WRAP color_term> |
| <WRAP color_command><html><pre> |
| <span style="color:#FF8700"><b>$</b></span> <span style="color:#26A269">touch</span><span style="color:#999999"> </span><span style="color:#999999"><u style="text-decoration-style:single">dokuwiki/conf/local.php</u></span> |
| </pre></html></WRAP> |
</WRAP> | </WRAP> |
| |
| |
===== トラブルシューティング ===== | ===== トラブルシューティング ===== |
| |
| ==== アップロードしたメディアの css や js の MIME タイプが "application/octet-stream" になる🤪 ==== |
| <WRAP zoomimg w600 x1_2> |
| {{:linux:css_js_application_octet-stream.png|MIME タイプ エラー}} |
| </WRAP> |
| メディアファイルの配信は DokuWiki によって行われ、<html><code>conf/mime.conf</code></html> に定義されている🤔\\ |
| 定義が足りていない場合は追加する😉\\ |
| <WRAP color_term> |
| <WRAP color_command><html><pre> |
| <font color="#0087FF"><b>$</b></font> <font color="#26A269">nano</font> <font color="#9E9E9E"><u style="text-decoration-style:solid">conf/mime.conf</u></font> |
| </pre></html></WRAP> |
| <WRAP color_mincode_long><html><pre> |
| <font color="#444444"> 1</font> <font color="#FFFFFF"># Allowed uploadable file extensions and mimetypes are defined here.</font> |
| <font color="#444444"> 2</font> <font color="#FFFFFF"># To extend this file it is recommended to create a mime.local.conf</font> |
| <font color="#444444"> 3</font> <font color="#FFFFFF"># file. Mimetypes that should be downloadable and not be opened in the</font> |
| <font color="#444444"> 4</font> <font color="#FFFFFF"># should be prefixed with a !</font> |
| <font color="#444444"> 5</font> |
| <font color="#444444"> 6</font> <font color="#FFFFFF">jpg image/jpeg</font> |
| <font color="#444444"> 7</font> <font color="#FFFFFF">jpeg image/jpeg</font> |
| <font color="#444444"> 8</font> <font color="#FFFFFF">gif image/gif</font> |
| <font color="#444444"> 9</font> <font color="#FFFFFF">png image/png</font> |
| <font color="#444444"> 10</font> <font color="#FFFFFF">webp image/webp</font> |
| <font color="#444444"> 11</font> <font color="#FFFFFF">ico image/vnd.microsoft.icon</font> |
| <font color="#444444"> 12</font> |
| <font color="#444444"> 13</font> <font color="#FFFFFF">mp3 audio/mpeg</font> |
| <font color="#444444"> 14</font> <font color="#FFFFFF">ogg audio/ogg</font> |
| <font color="#444444"> 15</font> <font color="#FFFFFF">wav audio/wav</font> |
| <font color="#444444"> 16</font> <font color="#FFFFFF">webm video/webm</font> |
| <font color="#444444"> 17</font> <font color="#FFFFFF">ogv video/ogg</font> |
| <font color="#444444"> 18</font> <font color="#FFFFFF">mp4 video/mp4</font> |
| <font color="#444444"> 19</font> <font color="#FFFFFF">vtt text/vtt</font> |
| <font color="#444444"> 20</font> |
| <font color="#444444"> 21</font> <font color="#FFFFFF">tgz !application/octet-stream</font> |
| <font color="#444444"> 22</font> <font color="#FFFFFF">tar !application/x-gtar</font> |
| <font color="#444444"> 23</font> <font color="#FFFFFF">gz !application/octet-stream</font> |
| <font color="#444444"> 24</font> <font color="#FFFFFF">bz2 !application/octet-stream</font> |
| <font color="#444444"> 25</font> <font color="#FFFFFF">zip !application/zip</font> |
| <font color="#444444"> 26</font> <font color="#FFFFFF">rar !application/rar</font> |
| <font color="#444444"> 27</font> <font color="#FFFFFF">7z !application/x-7z-compressed</font> |
| <font color="#444444"> 28</font> |
| <font color="#444444"> 29</font> <font color="#FFFFFF">pdf application/pdf</font> |
| <font color="#444444"> 30</font> <font color="#FFFFFF">ps !application/postscript</font> |
| <font color="#444444"> 31</font> |
| <font color="#444444"> 32</font> <font color="#FFFFFF">rpm !application/octet-stream</font> |
| <font color="#444444"> 33</font> <font color="#FFFFFF">deb !application/octet-stream</font> |
| <font color="#444444"> 34</font> |
| <font color="#444444"> 35</font> <font color="#FFFFFF">doc !application/msword</font> |
| <font color="#444444"> 36</font> <font color="#FFFFFF">xls !application/msexcel</font> |
| <font color="#444444"> 37</font> <font color="#FFFFFF">ppt !application/mspowerpoint</font> |
| <font color="#444444"> 38</font> <font color="#FFFFFF">rtf !application/msword</font> |
| <font color="#444444"> 39</font> |
| <font color="#444444"> 40</font> <font color="#FFFFFF">docx !application/vnd.openxmlformats-officedocument.wordprocessingml.document</font> |
| <font color="#444444"> 41</font> <font color="#FFFFFF">xlsx !application/vnd.openxmlformats-officedocument.spreadsheetml.sheet</font> |
| <font color="#444444"> 42</font> <font color="#FFFFFF">pptx !application/vnd.openxmlformats-officedocument.presentationml.presentation</font> |
| <font color="#444444"> 43</font> |
| <font color="#444444"> 44</font> <font color="#FFFFFF">sxw !application/soffice</font> |
| <font color="#444444"> 45</font> <font color="#FFFFFF">sxc !application/soffice</font> |
| <font color="#444444"> 46</font> <font color="#FFFFFF">sxi !application/soffice</font> |
| <font color="#444444"> 47</font> <font color="#FFFFFF">sxd !application/soffice</font> |
| <font color="#444444"> 48</font> |
| <font color="#444444"> 49</font> <font color="#FFFFFF">odc !application/vnd.oasis.opendocument.chart</font> |
| <font color="#444444"> 50</font> <font color="#FFFFFF">odf !application/vnd.oasis.opendocument.formula</font> |
| <font color="#444444"> 51</font> <font color="#FFFFFF">odg !application/vnd.oasis.opendocument.graphics</font> |
| <font color="#444444"> 52</font> <font color="#FFFFFF">odi !application/vnd.oasis.opendocument.image</font> |
| <font color="#444444"> 53</font> <font color="#FFFFFF">odp !application/vnd.oasis.opendocument.presentation</font> |
| <font color="#444444"> 54</font> <font color="#FFFFFF">ods !application/vnd.oasis.opendocument.spreadsheet</font> |
| <font color="#444444"> 55</font> <font color="#FFFFFF">odt !application/vnd.oasis.opendocument.text</font> |
| <font color="#444444"> 56</font> |
| <font color="#444444"> 57</font> <font color="#FFFFFF">svg image/svg+xml</font> |
| <font color="#444444"> 58</font> |
| <font color="#444444"> 59</font> <font color="#FFFFFF"># You should enable HTML and Text uploads only for restricted Wikis.</font> |
| <font color="#444444"> 60</font> <font color="#FFFFFF"># Spammers are known to upload spam pages through unprotected Wikis.</font> |
| <font color="#444444"> 61</font> <font color="#FFFFFF"># Note: Enabling HTML opens Cross Site Scripting vulnerabilities</font> |
| <font color="#444444"> 62</font> <font color="#FFFFFF"># through JavaScript. Only enable this with trusted users. You</font> |
| <font color="#444444"> 63</font> <font color="#FFFFFF"># need to disable the iexssprotect option additionally to</font> |
| <font color="#444444"> 64</font> <font color="#FFFFFF"># adding the mime type here</font> |
| <font color="#444444"> 65</font> <font color="#FFFFFF">#html text/html</font> |
| <font color="#444444"> 66</font> <font color="#FFFFFF">#htm text/html</font> |
| <font color="#444444"> 67</font> <font color="#FFFFFF">#txt text/plain</font> |
| <font color="#444444"> 68</font> <font color="#FFFFFF">#conf text/plain</font> |
| <font color="#444444"> 69</font> <font color="#FFFFFF">#xml text/xml</font> |
| <font color="#444444"> 70</font> <font color="#FFFFFF">#csv text/csv</font> |
| <font color="#444444"> 71</font> <span style="background-color:#303030"><font color="#FFFFFF">css text/css</font></span><span style="background-color:#303030"> </span> |
| <font color="#444444"> 72</font> <span style="background-color:#303030"><font color="#FFFFFF">js text/javascript</font></span><span style="background-color:#303030"> </span> |
| <font color="#444444"> 73</font> |
| <font color="#444444"> 74</font> <font color="#FFFFFF"># Also flash may be able to execute arbitrary scripts in the website's</font> |
| <font color="#444444"> 75</font> <font color="#FFFFFF"># context</font> |
| <font color="#444444"> 76</font> <font color="#FFFFFF">#swf application/x-shockwave-flash</font> |
| <font color="#444444"> 77</font> |
| </pre></html></WRAP> |
| </WRAP> |
| |
==== GOTO Plugin リダイレクトしているページが Google Search Console がソフト 404 エラーを通知する場合の対処 ==== | ==== GOTO Plugin リダイレクトしているページが Google Search Console がソフト 404 エラーを通知する場合の対処 ==== |
COM_siteFooter関数内1,514行目(*1)付近(フッターに出力しているscriptを止める)\\ | COM_siteFooter関数内1,514行目(*1)付近(フッターに出力しているscriptを止める)\\ |
*1 - 1.8.0 の行番号, 2.0.0 では 1,570行目付近。 | *1 - 1.8.0 の行番号, 2.0.0 では 1,570行目付近。 |
<sxh php highlight:[2]> | <code php highlight:[2]> |
// Retrieve any JavaScript libraries, variables and functions | // Retrieve any JavaScript libraries, variables and functions |
//$footercode = $_SCRIPTS->getFooter(); | //$footercode = $_SCRIPTS->getFooter(); |
</sxh> | </code> |
| |
COM_siteHeader関数内1,286行目(*2)付近(ヘッダーの新たなテーマ変数plg_extrascriptにscriptを出力する)\\ | COM_siteHeader関数内1,286行目(*2)付近(ヘッダーの新たなテーマ変数plg_extrascriptにscriptを出力する)\\ |
*2 - 1.8.0 の行番号, 2.0.0 では 1,337行目付近。 | *2 - 1.8.0 の行番号, 2.0.0 では 1,337行目付近。 |
<sxh php highlight:[3,4]> | <code php highlight:[3,4]> |
$headercode = $_SCRIPTS->getHeader() . $headercode; | $headercode = $_SCRIPTS->getHeader() . $headercode; |
$header->set_var( 'plg_headercode', $headercode ); | $header->set_var( 'plg_headercode', $headercode ); |
// Retrieve any JavaScript libraries, variables and functions | // Retrieve any JavaScript libraries, variables and functions |
$header->set_var('plg_extrascript', $_SCRIPTS->getFooter()); | $header->set_var('plg_extrascript', $_SCRIPTS->getFooter()); |
</sxh> | </code> |
| |
使っているテーマの header.thtml に追記する。 | 使っているテーマの header.thtml に追記する。 |
<sxh html highlight:[13]> | <code html highlight:[13]> |
{doctype} | {doctype} |
<html{html_attribute}{xmlns}> | <html{html_attribute}{xmlns}> |
{plg_extrascript} | {plg_extrascript} |
</head> | </head> |
</sxh> | </code> |
| |
==== forum.css の修正 ==== | ==== forum.css の修正 ==== |
Geeklog Forum Plugin の forum.css が Dokuwiki の syntaxhighlighter3 に悪影響するので修正\\ | Geeklog Forum Plugin の forum.css が Dokuwiki の syntaxhighlighter3 に悪影響するので修正\\ |
**%%/path/to/public_html/forum/forum/layout/forum.css%%** | **%%/path/to/public_html/forum/forum/layout/forum.css%%** |
<sxh css> | <code css> |
/* CSS Declarations for Code block feature - default will use the .php one */ | /* CSS Declarations for Code block feature - default will use the .php one */ |
.pluginSolidOutline div .php { max-height:400px; overflow:auto; height:auto; width:auto; min-height:100px; } | .pluginSolidOutline div .php { max-height:400px; overflow:auto; height:auto; width:auto; min-height:100px; } |
.pluginSolidOutline div .html { height:300px; overflow:auto; width:auto; min-height:100px; } | .pluginSolidOutline div .html { height:300px; overflow:auto; width:auto; min-height:100px; } |
.pluginSolidOutline div .css { height:300px; overflow:auto; width:auto; min-height:100px; } | .pluginSolidOutline div .css { height:300px; overflow:auto; width:auto; min-height:100px; } |
</sxh> | </code> |
| |
| ===== ☢️古い資料です (Obsolete)☢️ ===== |
| |
===== geeklogのDokuWiki Plugin(注意: 以下は古い情報です) ===== | ==== geeklogのDokuWiki Plugin ==== |
| |
==== 管理者用のサイト設定 ==== | === 管理者用のサイト設定 === |
使用言語: ja で日本語化されない場合は、/dokuwiki/conf/local.protected.phpにて追加設定を行う。\\ | 使用言語: ja で日本語化されない場合は、/dokuwiki/conf/local.protected.phpにて追加設定を行う。\\ |
**local.protected.php** に __**$conf['lang'] = 'ja';**__ を追加\\ | **local.protected.php** に __**$conf['lang'] = 'ja';**__ を追加\\ |
[[https://you84815.blogspot.com/2017/01/dokuwikicontent-security-policy.html|tobijibu-ashiato: DokuWikiのContent-Security-Policy対応方法]]\\ | [[https://you84815.blogspot.com/2017/01/dokuwikicontent-security-policy.html|tobijibu-ashiato: DokuWikiのContent-Security-Policy対応方法]]\\ |
[[https://laboradian.com/show-text-immediately-using-font-display/|Webフォントを使う場合に font-display 記述子を使ってすぐにテキストを表示させる – ラボラジアン]]\\ | [[https://laboradian.com/show-text-immediately-using-font-display/|Webフォントを使う場合に font-display 記述子を使ってすぐにテキストを表示させる – ラボラジアン]]\\ |
| [[https://www.achiachi.net/blog/index.html|トップページ [あちあち情報局]]]\\ |
| |
==== 付録 ==== | ==== 付録 ==== |