借助 Typora 在喵玉殿發布 Markdown 文檔的操作流程
本帖最后由 タユタイ 于 2021-5-23 03:17 编辑# 前言公告版有人提出了想用 Markdown 在喵玉寫文檔的需求，其實我不久前也有這個想法，與我不謀而合了。Discuz! 雖然有 Markdown 的插件，但因爲是收費的，而且 Discuz! 的源碼過於古早很難維護，經過討論後我們認爲不值得花這個成本。
不過我試想並驗證本文論述的一個操作較爲簡單的方法，希望有心的同志可以嘗試一下。
本文即使用此方式書寫。
爲不熟 Markdown 的同志介紹一下：Markdown 是一種標記語言(Markup Language)，大家對其中的 HTML 應該比較熟悉。相較於 HTML，Markdown 的學習和書寫成本都較低，最後是轉換成 HTML 代碼，天生兼容性強。大家應該知道同樣的 HTML 文件在任意電腦上顯示的排版是完全一樣的（樣式也許會有差異），所以相較於 Word 和富文本(Ricth Text)，和 HTML 同爲標記語言的 Markdown 在書寫和分享的成本上都很低。
目録（Discuz! 貌似不支持片段標識符，暫時請不要點撃目録）
[*]一、下載並安裝 Typora
[*]二、書寫 Markdown 文檔
[*]三、在喵玉殿上發表 Markdown 文檔
一、下載並安裝 Typora
[*]這是一個支持 Markdown 語法的文本編輯器
[*]官網：https://typora.io/
[*]文檔：https://support.typora.io/
[*]程序外觀：
[*]源碼模式：https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5xxdlylp2u40.png
[*]純文本模式：https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.25vz44zk4r5s.png
※ 網站内容爲英文，下載應該沒有難度。但如果要看文檔的話，建議使用 chrome 自帶的翻譯功能等機翻工具粗略翻譯一下再看。也可以找一找中文的講解。※ 程序的菜單語言應該默認是英文，不過是支持中文的（簡繁都有），大家可以自己改一下。
二、書寫 Markdown 文檔
[*]基本語法的簡單教程：60秒學會Markdown（英文）
[*]基本是看圖說話，不用擔心英文看不懂。實在不行可以百度一下中文教程。
[*]詳細文檔：CommonMark Spec（英文）
[*]機翻的質量很差，不過原理都很直觀。文檔極長，沒有耐心不建議去看。
[*]注意要在編輯器的源碼模式下書寫。
三、在喵玉殿上發表 Markdown 文檔
[*]點撃發貼窗口中的高級模式。https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.3vrmi269m8w0.png
[*]在 Typora 的純文本模式中全選全文並複制純文本。
[*]如果 Typora 編輯器的下方狀態欄的左側顯示處於源碼模式，點撃它可以切換到純文本模式。
[*]源碼模式的狀態欄：https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5o59qxe6g980.png
[*]純文本模式的狀態欄：https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.7ayfz5qikq80.png
[*]如果粘貼後發現不是純文本（比如出現 HTML tag 等），可以在編輯器上方菜單欄的編輯中修改默認的複製形式。https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5dkwk0dvmco0.png
[*]粘貼複製的内容置喵玉殿發貼窗口的高級模式中。https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.4ohzm9y3o3o0.png
[*]注意不要勾選發貼窗口右上解的純文本模式。
[*]最後點撃發布按鈕即可。
[*]可以正常顯示圖片、鏈接等功能。
[*]樣式和換行會有BUG。
[*]貌似不支持下畫線及實體編碼。
© 2021 雪域冰龍(タユタイ本人) 轉載注明本行内容即可。 本帖最后由 タユタイ 于 2021-5-23 03:24 编辑
這樓發一下源碼，可以看出樣式還是有些不盡如人意的。
實際因爲發現換行會有BUG，所以還在此基础上對長文段落的換行做了一些修改。
# 借助 Typora 在喵玉殿發布 Markdown 文檔的操作流程
## # 前言
公告版有人提出了想用 Markdown 在喵玉寫文檔的需求，其實我不久前也有這個想法，與我不謀而合了。
Discuz! 雖然有 Markdown 的插件，但因爲是收費的，而且 Discuz! 的源碼過於古早很難維護，經過討論後我們認爲不值得花這個成本。
不過我試想並驗證本文論述的一個操作較爲簡單的方法，希望有心的同志可以嘗試一下。
**本文即使用此方式書寫。**
*爲不熟 Markdown 的同志介紹一下：*
Markdown 是一種標記語言(Markup Language)，大家對其中的 HTML 應該比較熟悉。
相較於 HTML，Markdown 的學習和書寫成本都較低，最後是轉換成 HTML 代碼，天生兼容性強。
大家應該知道同樣的 HTML 文件在任意電腦上顯示的排版是完全一樣的（樣式也許會有差異），
所以相較於 Word 和富文本(Ricth Text)，和 HTML 同爲標記語言的 Markdown 在書寫和分享的成本上都很低。
---
## 目録（Discuz! 貌似不支持片段標識符，暫時請不要點撃目録）
- [一、下載並安裝 Typora](#一、下載並安裝-Typora)
- [二、書寫 Markdown 文檔](#二、書寫-Markdown-文檔)
- [三、在喵玉殿上發表 Markdown 文檔](#三、在喵玉殿上發表-Markdown-文檔)
---
## 一、下載並安裝 Typora
- 這是一個支持 Markdown 語法的文本編輯器
- 官網：<https://typora.io/>
- 文檔：<https://support.typora.io/>
- 程序外觀：
- 源碼模式：!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5xxdlylp2u40.png)
- 純文本模式：!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.25vz44zk4r5s.png)
※ 網站内容爲英文，下載應該沒有難度。但如果要看文檔的話，建議使用 chrome 自帶的翻譯功能等機翻工具粗略翻譯一下再看。也可以找一找中文的講解。
※ 程序的菜單語言應該默認是英文，不過是支持中文的（簡繁都有），大家可以自己改一下。
---
## 二、書寫 Markdown 文檔
- 基本語法的簡單教程：(https://commonmark.org/help/)
- 基本是看圖說話，不用擔心英文看不懂。實在不行可以百度一下中文教程。
- 詳細文檔：(https://spec.commonmark.org/)
- 機翻的質量很差，不過原理都很直觀。文檔極長，沒有耐心不建議去看。
- 注意要在編輯器的源碼模式下書寫。
---
## 三、在喵玉殿上發表 Markdown 文檔
1. 點撃發貼窗口中的**高級模式**。
!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.3vrmi269m8w0.png)
2. 在 Typora 的純文本模式中全選全文並複制純文本。
- 如果 Typora 編輯器的下方狀態欄的左側顯示處於**源碼模式**，點撃它可以切換到**純文本模式**。
- 源碼模式的狀態欄：
!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5o59qxe6g980.png)
- 純文本模式的狀態欄：
!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.7ayfz5qikq80.png)
- 如果粘貼後發現不是純文本（比如出現 HTML tag 等），可以在編輯器上方菜單欄的**編輯**中修改默認的複製形式。
!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5dkwk0dvmco0.png)
3. 粘貼複製的内容置喵玉殿發貼窗口的**高級模式**中。
!(https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.4ohzm9y3o3o0.png)
- 注意不要勾選發貼窗口右上解的純文本模式。
4. 最後點撃**發布按鈕**即可。
- 可以正常顯示圖片、鏈接等功能。
- 樣式和換行會有BUG。
- 貌似不支持下畫線及實體編碼。
---
© 2021 雪域冰龍(タユタイ本人) 轉載注明本行内容即可。
页:
[1]