设为首页收藏本站喵玉殿官方微博

喵玉殿论坛 · 喵玉汉化组

 找回密码
 少女注册中
搜索
查看: 187|回复: 1

[编程算法] 借助 Typora 在喵玉殿發布 Markdown 文檔的操作流程

[复制链接]
发表于 2021-5-23 02:00:06 | 显示全部楼层 |阅读模式
本帖最后由 タユタイ 于 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
※ 網站内容爲英文,下載應該沒有難度。但如果要看文檔的話,建議使用 chrome 自帶的翻譯功能等機翻工具粗略翻譯一下再看。也可以找一找中文的講解。※ 程序的菜單語言應該默認是英文,不過是支持中文的(簡繁都有),大家可以自己改一下。


二、書寫 Markdown 文檔
  • 基本語法的簡單教程:60秒學會Markdown(英文)
    • 基本是看圖說話,不用擔心英文看不懂。實在不行可以百度一下中文教程。

    • 機翻的質量很差,不過原理都很直觀。文檔極長,沒有耐心不建議去看。

  • 注意要在編輯器的源碼模式下書寫。



三、在喵玉殿上發表 Markdown 文檔
  • 點撃發貼窗口中的高級模式
  • 在 Typora 的純文本模式中全選全文並複制純文本。
    • 如果 Typora 編輯器的下方狀態欄的左側顯示處於源碼模式,點撃它可以切換到純文本模式
      • 源碼模式的狀態欄:
      • 純文本模式的狀態欄:

    • 如果粘貼後發現不是純文本(比如出現 HTML tag 等),可以在編輯器上方菜單欄的編輯中修改默認的複製形式。

  • 粘貼複製的内容置喵玉殿發貼窗口的高級模式中。
    • 注意不要勾選發貼窗口右上解的純文本模式。

  • 最後點撃發布按鈕即可。
    • 可以正常顯示圖片、鏈接等功能。
    • 樣式和換行會有BUG。
    • 貌似不支持下畫線及實體編碼。




© 2021 雪域冰龍(タユタイ本人) 轉載注明本行内容即可。
 楼主| 发表于 2021-5-23 02:21:06 | 显示全部楼层
本帖最后由 タユタイ 于 2021-5-23 03:24 编辑

這樓發一下源碼,可以看出樣式還是有些不盡如人意的。
實際因爲發現換行會有BUG,所以還在此基础上對長文段落的換行做了一些修改。

  1. # 借助 Typora 在喵玉殿發布 Markdown 文檔的操作流程

  2. ## # 前言

  3. 公告版有人提出了想用 Markdown 在喵玉寫文檔的需求,其實我不久前也有這個想法,與我不謀而合了。  
  4. Discuz! 雖然有 Markdown 的插件,但因爲是收費的,而且 Discuz! 的源碼過於古早很難維護,經過討論後我們認爲不值得花這個成本。  

  5. 不過我試想並驗證本文論述的一個操作較爲簡單的方法,希望有心的同志可以嘗試一下。

  6. **本文即使用此方式書寫。**

  7. *爲不熟 Markdown 的同志介紹一下:*  
  8. Markdown 是一種標記語言(Markup Language),大家對其中的 HTML 應該比較熟悉。  
  9. 相較於 HTML,Markdown 的學習和書寫成本都較低,最後是轉換成 HTML 代碼,天生兼容性強。  
  10. 大家應該知道同樣的 HTML 文件在任意電腦上顯示的排版是完全一樣的(樣式也許會有差異),  
  11. 所以相較於 Word 和富文本(Ricth Text),和 HTML 同爲標記語言的 Markdown 在書寫和分享的成本上都很低。

  12. ---

  13. ## 目録(Discuz! 貌似不支持片段標識符,暫時請不要點撃目録)

  14. - [一、下載並安裝 Typora](#一、下載並安裝-Typora)
  15. - [二、書寫 Markdown 文檔](#二、書寫-Markdown-文檔)
  16. - [三、在喵玉殿上發表 Markdown 文檔](#三、在喵玉殿上發表-Markdown-文檔)

  17. ---

  18. ## 一、下載並安裝 Typora

  19. - 這是一個支持 Markdown 語法的文本編輯器
  20. - 官網:<https://typora.io/>
  21. - 文檔:<https://support.typora.io/>
  22. - 程序外觀:
  23.   - 源碼模式:![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5xxdlylp2u40.png)
  24.   - 純文本模式:![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.25vz44zk4r5s.png)

  25. ※ 網站内容爲英文,下載應該沒有難度。但如果要看文檔的話,建議使用 chrome 自帶的翻譯功能等機翻工具粗略翻譯一下再看。也可以找一找中文的講解。
  26. ※ 程序的菜單語言應該默認是英文,不過是支持中文的(簡繁都有),大家可以自己改一下。

  27. ---

  28. ## 二、書寫 Markdown 文檔

  29. - 基本語法的簡單教程:[60秒學會Markdown(英文)](https://commonmark.org/help/)
  30.   - 基本是看圖說話,不用擔心英文看不懂。實在不行可以百度一下中文教程。
  31. - 詳細文檔:[CommonMark Spec(英文)](https://spec.commonmark.org/)
  32.   - 機翻的質量很差,不過原理都很直觀。文檔極長,沒有耐心不建議去看。
  33. - 注意要在編輯器的源碼模式下書寫。

  34. ---

  35. ## 三、在喵玉殿上發表 Markdown 文檔

  36. 1. 點撃發貼窗口中的**高級模式**。

  37.      ![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.3vrmi269m8w0.png)

  38. 2. 在 Typora 的純文本模式中全選全文並複制純文本。
  39.    - 如果 Typora 編輯器的下方狀態欄的左側顯示處於**源碼模式**,點撃它可以切換到**純文本模式**。
  40.      - 源碼模式的狀態欄:

  41.          ![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5o59qxe6g980.png)

  42.      - 純文本模式的狀態欄:

  43.          ![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.7ayfz5qikq80.png)

  44.    - 如果粘貼後發現不是純文本(比如出現 HTML tag 等),可以在編輯器上方菜單欄的**編輯**中修改默認的複製形式。

  45.        ![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.5dkwk0dvmco0.png)

  46. 3. 粘貼複製的内容置喵玉殿發貼窗口的**高級模式**中。

  47.      ![image](https://cdn.jsdelivr.net/gh/SetsuikiHyoryu/image-bed@master/image.4ohzm9y3o3o0.png)

  48.    - 注意不要勾選發貼窗口右上解的純文本模式。

  49. 4. 最後點撃**發布按鈕**即可。
  50.    - 可以正常顯示圖片、鏈接等功能。
  51.    - 樣式和換行會有BUG。
  52.    - 貌似不支持下畫線及實體編碼。

  53. ---

  54. &#169; 2021 雪域冰龍(タユタイ本人) 轉載注明本行内容即可。
复制代码





回复 支持 1 反对 0

使用道具 举报

您需要登录后才可以回帖 登录 | 少女注册中

本版积分规则

合作与事务联系|小黑屋|手机版|无图版|喵玉殿

GMT+8, 2021-6-17 13:56

Powered by Discuz! X3.4

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表