差分

このページの2つのバージョン間の差分を表示します。

--- linux:dokuwiki [2024/03/14 16:43] – ともやん
+++ linux:dokuwiki [2025/03/28 12:27] (現在) – [DokuWiki プラグイン開発 (Devel)] ともやん
@@ 行 5: / 行 5: @@
 ===== 更新前に必ず確認‼️ =====
 [[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]] で対応
 ===== 技術資料 =====
@@ 行 379: / 行 384: @@
 [[:linux:dokuwiki:codeMirror_plugin|CodeMirror Plugin]]\\
-===== DokuWiki プラグイン開発 (Devel) =====
+==== DokuFreaks ====
-[[https://mizunashi-mana.github.io/blog/posts/2019/07/dokuwiki-syntax-plugin/|続くといいな日記 – DokuWiki の構文拡張プラグインの作り方]]\\
+[[https://github.com/dokufreaks|{{https://avatars.githubusercontent.com/u/86480?&.png?100x100&recache|DokuFreaks }}]]
-DokuWiki ソースコード閲覧\\
+[[git>dokufreaks|DokuFreaks]] GitHub 組織は、元の作成者によってほとんど放棄されたプラグインが **最小限** 維持される場所です。これは、言語の更新が適用され、簡単なプル リクエストが適用され、プラグインが通常、最近の DokuWiki リリースで動作する状態になる必要があることを意味します。
-[[https://xref.dokuwiki.org/reference/dokuwiki/nav.html|PHPXref: DokuWiki]]\\
-[[https://www.dokuwiki.org/devel:plugin_file_structure|devel:plugin_file_structure [DokuWiki]]]  ([[https://www-dokuwiki-org.translate.goog/devel:plugin_file_structure?_x_tr_sl=en&_x_tr_tl=ja&_x_tr_hl=ja&_x_tr_pto=sc|翻訳]])\\
-[[https://www.dokuwiki.org/devel:syntax_plugins|devel:syntax_plugins [DokuWiki]]] ([[https://www-dokuwiki-org.translate.goog/devel:syntax_plugins?_x_tr_sl=en&_x_tr_tl=ja&_x_tr_hl=ja&_x_tr_pto=sc|翻訳]])\\
+一方、これは、そこにリストされているプラグインが**積極的に開発されていない**ことを意味します。機能リクエストはほとんど無視され、マージに大きな労力が必要なプル リクエストはおそらく永久に無視されるでしょう。
+[[https://www.dokuwiki.org/dokufreaks|dokufreaks [DokuWiki]] より🤔\\
+===== DokuWiki プラグイン開発 (Devel) =====
+[[linux:dokuwiki:dokuWiki_plugin_development|DokuWiki プラグイン開発 (Devel)]]\\
 ===== DokuWiki テーマ カスタマイズ =====
@@ 行 855: / 行 861: @@
 ===== トラブルシューティング =====
+==== アップロードしたメディアの 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&apos;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 エラーを通知する場合の対処 ====
@@ 行 992: / 行 1089: @@
 COM_siteFooter関数内1,514行目(*1)付近(フッターに出力しているscriptを止める)\\
 *1 - 1.8.0 の行番号, 2.0.0 では 1,570行目付近。
-<sxh php highlight:[2]>
+<code php highlight:[2]>
     // Retrieve any JavaScript libraries, variables and functions
     //$footercode = $_SCRIPTS->getFooter();
-</sxh>
+</code>
 COM_siteHeader関数内1,286行目(*2)付近(ヘッダーの新たなテーマ変数plg_extrascriptにscriptを出力する)\\
 *2 - 1.8.0 の行番号, 2.0.0 では 1,337行目付近。
-<sxh php highlight:[3,4]>
+<code php highlight:[3,4]>
     $headercode = $_SCRIPTS->getHeader() . $headercode;
     $header->set_var( 'plg_headercode', $headercode );
     // Retrieve any JavaScript libraries, variables and functions
     $header->set_var('plg_extrascript', $_SCRIPTS->getFooter());
-</sxh>
+</code>
 使っているテーマの header.thtml に追記する。
-<sxh html highlight:[13]>
+<code html highlight:[13]>
 {doctype}
 <html{html_attribute}{xmlns}>
@@ 行 1022: / 行 1119: @@
 {plg_extrascript}
 </head>
-</sxh>
+</code>
 ==== forum.css の修正 ====
 Geeklog Forum Plugin の forum.css が Dokuwiki の syntaxhighlighter3 に悪影響するので修正\\
 **%%/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 */
 .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 .css { height:300px; overflow:auto; width:auto; min-height:100px; }
-</sxh>
+</code>
 ===== ☢️古い資料です (Obsolete)☢️ =====