外掛說明
An all-in-on WordPress Markdown Plugin provides a variety of features such as Markdown editor, live-preview, image-paste, HTML-to-Markdown helper, and more..
詳細的文件請參閱 https://github.com/terrylinooo/githuber-md。
示範
影片中展示了下列步驟:
- 使用
HTML 轉換 Markdown
工具把 HTML 轉換為 Markdown 語法。 - 從 Photoshop 剪下圖片的選區範圍,然後把它貼到 Markdown 語法編輯器。
- Click “Update” button to save Markdown to
post_content_filtered
and save HTML topost_content
(it is what you will see in result). - 檢視結果。
外掛運作方式
- WP Githuber MD 將會儲存您的 Markdown 內容至
wp_posts
.post_content_filtered
欄位。 - 解析 Markdown 語為 HTML語法,儲存已解析的 HTML 到
wp_posts
.post_content
欄位。
This plugin will detect your Markdown content and decide what scripts will be loaded, to avoid loading unnecessary scripts.
For example, if you enabled Syntax highlight, you have to update your post again to take effects.
建議
使用這個外掛比較理想的情況是當您才剛開始經營一個新部落格的時候。
如果您打算使用這個外掛在現行部落格上,務必要:
- 停用其它的 Markdown 外掛,因為類似的外掛可能運作方式一樣,在送出文章時轉換格式。可能導至重複轉碼問題。
- 我的建議是停用草稿和自動存檔功能,選項在設定頁中。
特色
- Markdown 編輯器
- 即時預覽。
- 拼寫檢查
- 針對單一文章,啟用 / 停用 Markdown。
- 支援古騰堡編輯器。
- 支援客製的文章類型。
- Support Markdown extra syntax.
- HTML 轉換 Markdown 工具。
- 圖片隨貼(支援上傳至 imgur.com 及 sm.ms 圖床)
- Highlight code syntax. (prism.js or hightlight.js)
- 流程圖。
- kaTeX 數學公式。
- 序列圖表。
- 美人魚 (圖表模組)
- MathJax 數學套件。
- 表情圖示套件。
- GitHub 定義的 Markdown 任務列表。
- Fetch remote images.
- 關鍵字建議工具。
- and more…
本地化人員
English (en_US) by Colocal.
Traditional Chinese (zh_TW) by Alex Lion.
Simplified Chinese (zh_CN) by Terry Lin.
版權
WP Githuber MD, Copyright 2018-2020 TerryL.in
WP Githuber MD is distributed under the terms of the GNU GPL
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
螢幕擷圖
安裝方式
- 上傳外掛的檔案到
/wp-content/plugins/wp-githuber-md
資料夾,或者透過 WordPress中 的 “外掛” 屏幕安裝外掛。 - 在 WordPress 管理後台的 [外掛] 頁面啟用外掛。
- 前往外掛下的 WP Githuber MD 選單來設定您的 Markdown 選項。
常見問題集
您可以在 回報問題 找到您的問題的解答。
使用者評論
參與者及開發者
變更記錄
= 1.0.0
- 首次開放下載使用。
= 1.1.0
- 加上圖片隨貼模組。
= 1.2.0
- 圖片隨貼 – 提供可上傳至 Imgur.com 的功能選項。
- 更名 “Githuber MD” 為 “WP Githuber MD”。
- 加入新的設定。
= 1.2.5
- Add support to WordPress 5.0 – Thanks to Classic Editor plugin.
= 1.3.0
- 在 Markdown 編輯器旁邊放置
HTML 轉換Markdown
的小工具 - 加入选项让用户可以停用
自动储存
功能。 - 在关于我们加入更多资讯。
= 1.3.1
- 向下相容於 PHP 5.3 及 WordPress 4.0.x. (已在 PHP 5.3.5 及 WordPress 4.0.25 測試成功)
- 修改了 HTML 轉換 Markdown 小工具和圖片隨貼的介紹內容。
- 加入语言包版型
- 改善 HTML 转换 Markdown 的小工具
= 1.3.2
- 加入語言包: zh_TW.
- Fix bugs.
= 1.4.0
- 加入美人魚模組。
- 加入語言包: zh_CN.
- 修復 Bug。
= 1.4.1
- 新增行號顯示設定。
- 調整 KaTeX 模組 – 現在可以用 Markdown 語法區塊定義
katax
使用。 - 改進 Markdown 編輯器 – 調整小視窗按紐的外觀及修正版面跑版問題。
- Yoast SEO 有一個 CSS 全域樣式名稱為
path
使用了動化效果,這個會破壞美人魚圖表模組的 SVG 預覽顯示,因為他們定義了同樣的常見樣式名稱。我們只好強行移除該動化效果讓它正常顯示。
= 1.4.2
- 問題修正: HTML 轉 Markdown 小工具。
= 1.4.3
- 問題修正 #3 – 感謝 wojciehm@github 回報問題。
- 如果 PHP 版本未達到最低要求,顯示警告。
= 1.5.0
- 偵測 Jetpack Markdown 模組。
= 1.5.2
- 修復 bug:插入圖片無法運作(問題回報 #6)
- 支援 KaTeX 行間顯示。(功能請求 #7)
- 加入 Markdown 擴展語法支援 HTML 5
figure
標籤。(功能請求 #8)
= 1.6.0
- 支援客製文章類型。
- 加入
啟用 Markdown
選項,在編輯器旁。 - 支援古騰堡編輯器。現在您可以針對文章停用 Markdown 然後回到古騰堡編輯器。
= 1.6.2
- 在圖片隨貼模組中加入新的功能選項。(功能請求 #16)
- 增加一個選項,在使用媒體庫
加入圖片
可以讓用戶插入 HTML 到編輯器中(功能請求 #17) - 修復 bug:停用對文章類型後,富本文編輯器未出現。(問題回報 #15)
- 改進:美化 Markdown 切換器。
= 1.7.0
- 改進設定頁面的用戶介面。
- 在設定頁面中加入範例。
- 問題回報 #22 – 腳尾附註。
- 功能請求 #19 – 加入對短代碼的支援。
- 及其它問題回報…
= 1.7.1
- 修正 bug 和一點點改進。
= 1.7.2
- 修正問題:關閉修訂無法作用。
- 加入贊助資訊。
= 1.7.3
- 修正問題:#29,問題 #30 及 #31。
- 修正問題:Markdown extra 未作用。
= 1.7.4
- 修正 JavaScript 語法錯誤(打開連結模式)
= 1.8.0
- 修正問題 #39:在同步捲軸選項關閉時即時預覽沒有作用。
- 特色請求 #36:圖片隨貼 – 支援 sm.ms 圖床。
- 修正 bug:第一次啟用外掛時無正確註冊 register_activation_hook
- 修正問題:在反安裝時套用錯誤的變數名稱。
= 1.8.1
- 修正問題:wp_get_attachment_url() 無法區分頁面是 HTTP 或 HTTPS
- 修正問題 #38 – 保留行內代碼區塊。
- 加入簡體中文語言包。
= 1.8.2
- 修正問題 #42:Markdown 語法在兩段行間代碼區塊中生效。
= 1.8.5
- 新增功能:Githuber MD 擴充 – 鍵盤樣式的行間代碼區塊。例:
{ctrl}
- 修正問題:行間代碼區塊在只有一個字元的情況下無法作用。舉例
a
。這個問題和 #42 相關。
= 1.8.6
- 修正問題 #44:無法插入被連結的圖片。
- 修正問題 #45:HTML 轉換 Markdown 無法轉譯表格。
= 1.9.0
- Add feature: TOC (Table of contents) module.
- 新增功能:把網址中的
&
轉換為&
。
= 1.9.1
- 修正問題 #48:因為某些系統未安裝
php_fileinfo
因此用$_FILES['type']
替代。
= 1.10.0
- 功能請求 #53: 加入
複製到剪貼簿
按紐到代碼高亮的區塊中。 - 修正問題 #52 – 移除字串搜尋的醒目效果。
- 修正問題 #57 – 在列比中保留代碼區塊。
= 1.10.1
- 功能請求 #59:把前端加入的 .css 和 .js 移往行間的 script 區塊。
- 問題 #62:修正 [加入媒體] 按紐對於其它媒體類型檔案例如:聲音。
- 修正在 marked.js 中不正確的連結顏色。
- 問題 #49:圖片插入在文件尾端。
= 1.11.0
- 功能請求 #65:拼寫檢查。
- 新增設定在偏好設定。
= 1.11.1
- 修正問題 #68:無法正確顯示 JavaScript 樣板本文在代碼區塊中。
- 修正問題:內容綱要不該顯示在首頁在文章列表頁。
- 改進:拼寫檢查相容性檢測。
- 改進:讓 Markdown 語法也可用在代碼區塊中。
= 1.11.2
- 修正問題 #31 – 因為修改問題 #57 又重現此問題。
= 1.11.3
- 修正問題 #70: 當增加特色圖片時產生的問題。
- 修正問題 #71: 支持 Shortcodes Ultimate 插件。
= 1.11.4
- 修正問題 #72: 語法高亮 – 使用 prism 自動載入器代替。
- 功能請求 #74: 增加一個選項給對照螢光筆。
= 1.11.5
- Jetpack compatibility #80, #81, thanks @jeherve
- 修正問題 #92
- 移除捐款資訊。
= 1.11.6
- 修正問題 #89 – 程式碼區塊解析問題。
- Fix issue #96 – KaTex not working when using only inline syntax.
= 1.11.7
- Fix issue #99 – a CSS conflict in menu page.
- Fix issue #91 – post_id check.
- Feature request #98 – Add a new option in Preferences.
= 1.11.8
- Fix issue #107 – Fix parsing inline KaTax syntax.
- Fix issue #104 – UL list does not display correctly in the preview panel.
= 1.11.9
- Fix issue #126 – Conflict with WordPress 5.3 (
add_plugins_menu
function changes ) - PR #118 – Allow adding links to other file types rather than only inserting images.
= 1.12.0
- Feature request #75 – Save images to local folder.
- 新功能 – 語法高亮模組 highlight.js
- Hide
support comment
option because it doesn’t work now. - 更新 uninstall.php
= 1.12.1
- 設定連結移到選項次選單。
= 1.12.2
- Fix issue #144 – Deregistering
autosave
script gives error. (Fixed by alpipego. Thanks for contributing.) - 修正問題 #143 – 無法上傳圖片至 sm.ms. (第 v1 版 API 已停用)
- 修正問題 #147 – 更新 CodeMirror 樣式。
= 1.13.0
- 新功能 – MathJax 數學模組。
= 1.13.1
- 修正臭蟲 – Markdown 類別缺少屬性參數。
= 1.14.0
- 功能請求 #86, #135 – Emojify 表情圖示模組。
- 修正問題 #163 – 更新 KaTex 套件版本。
- 修正問題 #127 及 #149 – 連結開啟的方式。
- 修正問題 #156 – 語法高亮的 C 程式碼區塊
- 修正問題 #120 – 流程圖識別代碼 – flow,與 Prism 套件衝突。
- 修正問題 #103 – Markdown 編輯器界面 – 加入支援簡體中文。
= 1.15.0
- 新功能 – 關鍵字建議工具。
= 1.15.1
- Fix issue #184 – The position of typing dialog should be under the focused line.
- Fix issue #187 – Task List – Compatible with PHP 7.4
= 1.15.2
- Fix errors in WP CLI.
= 1.16.0
- Fix issue #209 – HTML unescaped in code blocks.
- Fix issue #210 – Inline MathJax is not displayed.
- Upgrade Mermaid JavaScript library from 8.0.0 to 8.9.0
- Upgrade KaTax JavaScript library from 0.11.1 to 0.12.0
- Upgrade Flowchart.js JavaScript library from 1.11.3 to 1.14.1
= 1.16.1
- Fix issue #253 – KaTax… by xxNull-lsk
- Fix issue #252 – Bulk action… by hmaragy
- Improve #252 Update composer.json to allow bedrock installs by jawngee
- Fix issue #230 – jsdeliver url by Bronya0
- Test up to WordPress 5.8.1
- Test up to PHP 8.0
= 1.16.2
- Test for compatibility with WordPress 6.2.2 and PHP 8.2.5 (No new updates for this version, just testing for compatibility)
- Fix coding style.
- Mermaid.js has been updated to 9.4.3