Skip to content

Commit

Permalink
Commit 2024-05-11 21:50:16:515
Browse files Browse the repository at this point in the history
  • Loading branch information
html5syt committed May 11, 2024
1 parent ee2a902 commit 0144ecc
Show file tree
Hide file tree
Showing 6 changed files with 59 additions and 13 deletions.
22 changes: 11 additions & 11 deletions .obsidian/workspace-mobile.json
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
"state": {
"type": "markdown",
"state": {
"file": "docs/basic/2.7.第三方登录.md",
"file": "docs/advanced/3.4.markdown-bbcode.md",
"mode": "source",
"source": false
}
Expand Down Expand Up @@ -104,7 +104,7 @@
"state": {
"type": "backlink",
"state": {
"file": "docs/basic/2.7.第三方登录.md",
"file": "docs/advanced/3.4.markdown-bbcode.md",
"collapseAll": false,
"extraContext": false,
"sortOrder": "byCreatedTimeReverse",
Expand All @@ -121,7 +121,7 @@
"state": {
"type": "outgoing-link",
"state": {
"file": "docs/basic/2.7.第三方登录.md",
"file": "docs/advanced/3.4.markdown-bbcode.md",
"linksCollapsed": false,
"unlinkedCollapsed": true
}
Expand All @@ -133,7 +133,7 @@
"state": {
"type": "outline",
"state": {
"file": "docs/basic/2.7.第三方登录.md"
"file": "docs/advanced/3.4.markdown-bbcode.md"
}
}
},
Expand Down Expand Up @@ -172,12 +172,17 @@
},
"active": "890b76675b7f2fc3",
"lastOpenFiles": [
"docs/basic/2.1.注册&登录.md",
"docs/basic/index.md",
"docs/about/社区准则.md",
"docs/basic/2.7.第三方登录.md",
"docs/advanced/3.4.markdown-bbcode.md",
"docs/index.md",
"docs/about/index.md",
"docs/advanced/index.md",
"docs/basic/2.3.发帖页.md",
"advanced/3.2.文件照片上传.html.md",
"advanced",
"docs/basic/2.1.注册&登录.md",
"docs/about/社区准则.md",
"docs/end.md",
"docs/info/iconsearch.md",
"docs/info/4.2.转存表情包.md",
Expand All @@ -190,9 +195,7 @@
"docs/custom/partials/copyright.html",
"docs/advanced/3.3.pwa.md",
"docs/advanced/3.2.文件照片上传.md",
"docs/basic/2.3.发帖页.md",
"docs/advanced/3.1.私密主题.md",
"docs/advanced/index.md",
"docs/basic/2.2.主界面.md",
"未命名",
"docs/basic/2.6.个人设置.md",
Expand All @@ -203,11 +206,8 @@
"docs/about.md",
"10856822.tmp",
"docs/assets/fa-light-300.woff2",
"docs/assets/fa-light-300.woff",
"docs/information/4.2.转存表情包.md",
"docs/information/4.1.dns解析流程图(暂未完成).md",
"docs/advanced/advanced.md",
"docs/basic/basic.md",
"docs/images/material.png",
"docs/images/graduate-cap.96x96.png",
"docs/images/graduate-cap.png",
Expand Down
42 changes: 42 additions & 0 deletions docs/advanced/3.4.markdown-bbcode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# 3.4 Markdown 与 BBCode

## 3.4.1 Markdown

> 摘自维基百科:
>
> Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Discord、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被用来撰写电子书。
这是一种很简单的语言,不比英语语法复杂,容易上手,本文档大部分使用它编写。你可以在网上搜索“Markdown语法教程”,学习基础语法即可应对社区发帖中的绝大多数情况。

*另外,我曾经翻译过一本老外写的Markdown语法手册,解析详尽。你可以在[这里](/assets/markdown.pdf)下载。*

## 3.4.2 BBCode

> 摘自维基百科:
>
> BBCode是Bulletin Board Code的缩写,有译为“BB代码”者,属于轻量级标记语言(Lightweight Markup Language)的一种,如字面上所显示的,它主要是使用在BBS、论坛、Blog等网络应用上。BBCode最初由Ultimate Bulletin Board讨论区系统发展出来,因此常见UBB代码的称呼。BBCode的语法通常为[標記]的形式,即语法左右用两个中括号包围,以作为与正常文字间的区别。系统解译时遇上中括弧便知道该处是BBcode,会在解译结果输出到客户端时转换成最为通用的HTML语法。
本社区目前启用如下BBCode插件:![pke8tFU.png](https://s21.ax1x.com/2024/05/11/pke8tFU.png)

看不懂?以下是所有插件说明:

!!! note "约定"

1. 加粗的为输入格式,重点关注!
2. 除第二项“BBCode”外,其他插件按照图片中从上到下的顺序解释。



=== "音频 BBCode"

**[audio mp3="song.mp3" ogg="song.ogg"]**
**[audio mp3="song.mp3"]**
**[audio ogg="song.ogg"]**
**[audio m4a="song.m4a"]**
**[audio wav="song.wav"]**
**[audio flac="song.flac"]**
**[audio webm="song.webm"]**
**[audio mp3="song.mp3" width="50"]**
(您可以将mp3和ogg文件放在一起以获得最大的浏览器兼容性,或者只是单独发布mp3, ogg, wav, flac, webm或m4a文件。此外,正如最后一个示例所示,您可以修改宽度。宽度将变成一个百分比,默认情况下,如果你选择不声明宽度,播放器将是100%的宽度。)

=== ""
Binary file added docs/assets/markdown.pdf
Binary file not shown.
5 changes: 4 additions & 1 deletion docs/basic/2.3.发帖页.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,10 @@
![pFnxoZ9.jpg](https://s11.ax1x.com/2024/01/27/pFnxoZ9.jpg)

功能区详解,放大了看。**建议使用富文本,可以直观的编辑帖子,部分兼容原来的Markdown纯文本模式**
*现增加文件上传功能,在富文本按钮前面,具体参考[3.2 文件/照片上传](/advanced/3.2.文件照片上传.html#322)*

**去“4. 实用工具&技术信息”看看BBCode和Markdown的使用方法吧,可以大大加强发帖体验!**

*现增加文件上传功能,在富文本按钮前面,具体参考[3.2 文件/照片上传](/advanced/3.2.文件照片上传.html)*

![po主Fnx2GV.jpg](https://s11.ax1x.com/2024/01/27/pFnx2GV.jpg)

2 changes: 1 addition & 1 deletion docs/custom/partials/copyright.html
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
</div>
{% endif %}
{% if not config.extra.generator == false %}
文档版本:3.0│正式修订日期:2024年5月1日<p class="p1"></p>
文档版本:3.1│正式修订日期:2024年5月12日<p class="p1"></p>

<script defer>
//格式:2020年04月12日 10:20:00 星期二
Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ nav:
- "3.1 私密主题": "advanced/3.1.私密主题.md"
- "3.2 文件&照片上传": "advanced/3.2.文件照片上传.md"
- "3.3 将社区安装为应用(PWA)": "advanced/3.3.pwa.md"
- "3.4 Markdown与BBCode": "advanced/3.4.markdown-bbcode.md"

- "4. 实用工具&技术信息":
- "4.1 DNS解析流程图(暂未完成)": "info/4.1.dns解析流程图(暂未完成).md"
Expand Down

0 comments on commit 0144ecc

Please sign in to comment.