本文æ供了如何在 Discourse ä¸ä½¿ç”¨ Markdown, BBCode, å’Œ HTML æ¥å‘å¸ƒæ ¼å¼åŒ–文本。
需è¦çš„用户级别:所有用户都å¯ä»¥ä½¿ç”¨
官方原文链接:Posting code or preformatted text
当有代ç 希望在 Discourse ä¸è¿›è¡Œåˆ†äº«çš„时候,或者针对一些错误日志需è¦å‘布在 Discourse 上的时候。如果我们ä¸å¯¹ä»£ç è¿›è¡Œæ ¼å¼åŒ–,对于这些内容读起æ¥æ˜¯éžå¸¸è´¹åŠ²çš„,åŒæ—¶åœ¨å¾ˆå¤šä»£ç ä¸ä¼šåŒ…å«æœ‰ç©ºæ ¼å’Œä¸€äº›å…¶ä»–çš„å—符,那么在内容转æ¢çš„时候,这些内容就会脱离其本æ„了。
在本指å—ä¸ï¼Œä½ å¯ä»¥å¦åˆ°ï¼š
è¦å¯¹è¡Œå†…的代ç 或者特殊文å—è¿›è¡Œæ ¼å¼åŒ–,在需è¦è¿›è¡Œæ ¼å¼åŒ–的内容å‰åŽéƒ¨åˆ†ä½¿ç”¨å•å¼•å·ã€‚
这个å¯ä»¥æ˜¯åœ¨ä¸€ä¸ªæ–‡æœ¬ä¸ï¼Œæˆ–者代ç 在å¦å¤–一行 。
行内代ç æ ¼å¼åŒ–ä¸ä¼šä¸ºè¦æ ¼å¼åŒ–的代ç åº”ç”¨ä»»ä½•æ ¼å¼ï¼ˆè¯·æŸ¥çœ‹ä¸‹é¢çš„示例),åªä¼šå¯¹è¦æ ¼å¼åŒ–的代ç 使用代ç æ ·å¼ï¼ˆâ€œcode styleâ€ï¼‰ã€‚
输入:
`This is a line of code`
输出:
This is a line of code
输入:
Here’s some text with `a bit of code` inside!
输出:
Here’s some text with a bit of code
inside!
如果需è¦å¯¹å½“行的代ç è¿›è¡Œæ ¼å¼åŒ–,那么åªéœ€è¦åœ¨å½“行的代ç å‰é¢æ·»åŠ 4 ä¸ªç©ºæ ¼å°±è¡Œã€‚
å•è¡Œä¸çš„æ‰€æœ‰å†…å®¹éƒ½ä¼šè¢«æ ¼å¼åŒ–æˆä»£ç ,直到下一行的开始。
输入:
All text after 4 spaces will be formatted.
输出:
All text after 4 spaces will be formatted.
针对多行代ç ,如果还使用å•è¡Œä»£ç è¿›è¡Œæ ¼å¼åŒ–çš„è¯ï¼Œé‚£ä¹ˆæ•´ä¸ªè¿‡ç¨‹å°±ä¼šæ˜¾å¾—éžå¸¸éº»çƒ¦ã€‚
尤其是很多代ç è¿˜ä¼šä½¿ç”¨ç©ºæ ¼è¿›è¡Œç¼©è¿›ã€‚
使用å•è¡Œç©ºæ ¼ä»£ç æ ¼å¼åŒ–将会影å“整个代ç å—的缩进。
这个时候å¯ä»¥ä½¿ç”¨ 3 个å•å¼•å·ï¼ˆbackticks (```))作为代ç 的开头,这 3 个å•å¼•å·éœ€è¦ç‹¬ç«‹æˆè¡Œã€‚
åŒæ—¶ï¼Œè¿™ä¸ª 3 个å•å¼•å·ä¹‹å‰ä¸èƒ½æœ‰ç©ºæ ¼ï¼Œå¦‚æžœæœ‰ç©ºæ ¼çš„è¯ï¼Œæ•´ä¸ªä»£ç å—å¯èƒ½æ— æ³•æ ¼å¼åŒ–。
输入:
``` public class CodeFormatting { public static void main(String[] args) { System.out.println("I can format code now!"); } } ```
输出:
public class CodeFormatting {
public static void main(String[] args) {
System.out.println("I can format code now!");
}
}
除了 Markdown æ ¼å¼åŒ–外,Discourse è¿˜èƒ½å¤Ÿæ”¯æŒ BBCode å’Œ HTML。
针对 HTML 使用 <pre>
和 <code>
æ ‡ç¾ï¼š
<pre><code>
public class CodeFormatting {
public static void main(String[] args) {
System.out.println("I can format code now!");
}
}
</code></pre>
针对 BBCode,使用 [code]
æ ‡ç¾ï¼š
[code]
public class CodeFormatting {
public static void main(String[] args) {
System.out.println("I can format code now!");
}
[/code]
在默认情下,Discourse ä¼šé’ˆå¯¹ä½ çš„è¾“å…¥æ ¼å¼æ¥è‡ªåŠ¨ä¾¦æµ‹ä½¿ç”¨çš„è¯è¨€ã€‚
å½“ç„¶ä½ ä¹Ÿå¯ä»¥æ‰‹åŠ¨é’ˆå¯¹ä»£ç å—指定è¯è¨€ï¼Œåœ¨ 3 个å•å¼•å·åŽé¢è¾“å…¥ä½ å¸Œæœ›æ ¼å¼åŒ–çš„è¯è¨€å³å¯ã€‚
``` your_language
# Your code here
针对 Ruby è¯è¨€ï¼š
输入:
``` ruby 3.times do |stuff| stuff.do end ```
输出:
3.times do |stuff|
stuff.do
end
能够支æŒçš„è¯è¨€å¿…须是下é¢èƒ½å¤Ÿæ”¯æŒè¯æ³•é«˜äº®çš„è¯è¨€ highlighted languages`。
能够支æŒçš„è¯è¨€åˆ—表å¯ä»¥åœ¨ on GitHub 页é¢ä¸è®¿é—®åˆ°ã€‚
å½“ç„¶ï¼Œä½ å¯ä»¥å¯ä»¥ä½¿ç”¨ default code lang
é…ç½®æ¥é…置默认的è¯è¨€ã€‚
å¦‚æžœä½ ä¸å¸Œæœ›è¾“入的文本或者代ç å—使用任何è¯æ³•é«˜äº®ï¼Œé‚£ä¹ˆåœ¨è¯è¨€é€‰æ‹©éƒ¨åˆ†ä½¿ç”¨ text
æ¥ä»£æ›¿ã€‚
输入:
``` text
Your text to NOT highlight here
输出:
Your text to NOT highlight here
3 posts - 2 participants