1
0
wiki/Technology/SoftwareEngineering/技术文档/2.标点符号.html

301 lines
465 KiB
HTML
Raw Normal View History

2024-09-05 22:26:11 +08:00
<!DOCTYPE html>
<html><head><title>标点符号</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="标点符号"/><meta property="og:description" content="本文详细介绍了中文标点符号的规范使用,包括句号、逗号、顿号等,并讨论了中英文混用时的标点规则。."/><meta property="og:image" content="https://wiki.7wate.com/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="../../../static/icon.png"/><meta name="description" content="本文详细介绍了中文标点符号的规范使用,包括句号、逗号、顿号等,并讨论了中英文混用时的标点规则。."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><script async src="https://umami.7wate.com/script.js" data-website-id="c061efdc-95dd-4d21-9d04-a1ffda0a85b9"></script><script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?94d8ccb156eb7c65abf317e6e01cdba9";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script><script async src="https://www.googletagmanager.com/gtag/js?id=G-MHMEL0F832"></script><script>
(function() {
window.dataLayer = window.dataLayer || [];
function gtag() {
window.dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'G-MHMEL0F832');
})();
</script><link href="../../../index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&amp;family=Schibsted Grotesk:wght@400;700&amp;family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&amp;display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="../../../prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`../../../static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="Technology/SoftwareEngineering/技术文档/2.标点符号"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title "><a href="../../..">📚 X·Eden</a></h1><div class="spacer mobile-only"></div><div class="search "><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode "><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.447,9.447-14.65,22.008-14.65,35.36
<h3 id="句号">句号「。」<a aria-hidden="true" tabindex="-1" href="#句号" class="internal"> §</a></h3>
<p>句号用于标示一句话的结束。在 Markdown 中,句号的使用和平常无异。</p>
<blockquote>
<p>这是一个句子。</p>
</blockquote>
<h3 id="逗号">逗号「,」<a aria-hidden="true" tabindex="-1" href="#逗号" class="internal"> §</a></h3>
<p>逗号用于在句子中创建停顿,分隔句子的不同部分。</p>
<blockquote>
<p>我需要,苹果,香蕉,和橙子。</p>
</blockquote>
<h3 id="顿号">顿号「、」<a aria-hidden="true" tabindex="-1" href="#顿号" class="internal"> §</a></h3>
<p>顿号用于列举或枚举同类事物。</p>
<blockquote>
<p>我需要苹果、香蕉、和橙子。</p>
</blockquote>
<h3 id="分号">分号「;」<a aria-hidden="true" tabindex="-1" href="#分号" class="internal"> §</a></h3>
<p>分号用于连接两个相关的句子。</p>
<blockquote>
<p>我喜欢苹果;我也喜欢香蕉。</p>
</blockquote>
<h3 id="冒号">冒号「:」<a aria-hidden="true" tabindex="-1" href="#冒号" class="internal"> §</a></h3>
<p>冒号用于引出说明或解释,或引出直接引语。</p>
<blockquote>
<p>注:这是一句解释性的话。</p>
</blockquote>
<h3 id="引号--">引号「“ ”,‘ ’」<a aria-hidden="true" tabindex="-1" href="#引号--" class="internal"> §</a></h3>
<p>引号用于引用别人的言论。</p>
<blockquote>
<p>他说:“我喜欢你。”</p>
</blockquote>
<h3 id="括号">括号「()」<a aria-hidden="true" tabindex="-1" href="#括号" class="internal"> §</a></h3>
<p>括号用于添加解释,注释,或者附加的信息。</p>
<blockquote>
<p>我喜欢吃水果(如苹果,香蕉,橙子)。</p>
</blockquote>
<h3 id="书名号">书名号「《》」<a aria-hidden="true" tabindex="-1" href="#书名号" class="internal"> §</a></h3>
<p>书名号用于标注书籍,报纸,电影等作品的标题。</p>
<blockquote>
<p>我最近在读《哈利·波特》。</p>
</blockquote>
<h3 id="连接号-">连接号「-」<a aria-hidden="true" tabindex="-1" href="#连接号-" class="internal"> §</a></h3>
<p>连接号用于连接两个有直接关联的词语。</p>
<blockquote>
<p>中美 - 贸易</p>
</blockquote>
<h3 id="破折号">破折号「——」<a aria-hidden="true" tabindex="-1" href="#破折号" class="internal"> §</a></h3>
<p>破折号表示转折,解释,或者暂停。</p>
<blockquote>
<p>我喜欢吃水果——尤其是苹果。</p>
</blockquote>
<h3 id="省略号">省略号「……」<a aria-hidden="true" tabindex="-1" href="#省略号" class="internal"> §</a></h3>
<p>省略号表示语句的不连续。</p>
<blockquote>
<p>等待……</p>
</blockquote>
<h3 id="感叹号">感叹号「!」<a aria-hidden="true" tabindex="-1" href="#感叹号" class="internal"> §</a></h3>
<p>感叹号用于标识感叹或者强烈的情绪。</p>
<blockquote>
<p>太好了!</p>
</blockquote>
<h3 id="斜杠">斜杠「/」<a aria-hidden="true" tabindex="-1" href="#斜杠" class="internal"> §</a></h3>
<p>在 Markdown 中,斜杠被用作转义字符,表示接下来的字符应被解析为文字,而非 Markdown 语法。</p>
<blockquote>
<p>我* 喜欢* 你。</p>
<p>输出为:我<em>喜欢</em>你。</p>
</blockquote>
<h3 id="反斜杠">反斜杠「\」<a aria-hidden="true" tabindex="-1" href="#反斜杠" class="internal"> §</a></h3>
<p>在 Markdown 中,反斜杠主要用作转义字符。</p>
<blockquote>
<p>\\ 在 Markdown 中会输出一个斜杠:\。</p>
</blockquote>
<h3 id="反引号">反引号「`」<a aria-hidden="true" tabindex="-1" href="#反引号" class="internal"> §</a></h3>
<p>在 Markdown 中,反引号用于创建 <code>inline</code> 代码块。</p>
<blockquote>
<p>`print(Hello, World!)` 在 Markdown 中会输出一个 inline 代码块:<code>print('Hello, World!')</code></p>
</blockquote>
<h2 id="中文标点使用">中文标点使用<a aria-hidden="true" tabindex="-1" href="#中文标点使用" class="internal"> §</a></h2>
<p>使用中文标点符号时,推荐遵循以下规则。</p>
<ul>
<li>
<p>在中文语境下,<strong>标点符号应使用全角形式(即中文输入法下的标点符号)</strong>,不能使用半角形式(即英文输入法下的标点符号)。</p>
</li>
<li>
<p>中文全角标点符号两侧不应该有半角空格。</p>
</li>
</ul>
<blockquote>
<p>如果 CPU 设有限额□(从 K8S 指定的上限)□,则需要手动调整。❌</p>
<p>如果 CPU 设有限额(从 K8S 指定的上限),则需要手动调整。</p>
</blockquote>
<ul>
<li>句号、问号、叹号、逗号、顿号、分号、冒号、结束引号、结束括号等标点不应出现在一行的开头。</li>
</ul>
<blockquote>
<p>排版时注意某些
符号不能在行首
,别弄错了。❌</p>
<p>排版时注意某些
符号不能在行首,
别弄错了。</p>
</blockquote>
<ul>
<li>开始引号、开始括号、开始双书名号等标点不应出现在一行的末尾。</li>
</ul>
<blockquote>
<p>她对我们说:“
这书太赞了。”❌</p>
<p>Copy code 她对我们说:
“这书太赞了。”</p>
</blockquote>
<h2 id="中英文混用时的标点符号用法">中英文混用时的标点符号用法<a aria-hidden="true" tabindex="-1" href="#中英文混用时的标点符号用法" class="internal"> §</a></h2>
<p>在中文技术文档中,可能会出现英文,此时可能会使用全角形式的中文标点和半角形式的英文标点。在中英文混用时,需特别注意标点符号的使用。</p>
<p>这部分介绍在中英文交接处使用标点符号的规则。</p>
<h3 id="根本原则">根本原则<a aria-hidden="true" tabindex="-1" href="#根本原则" class="internal"> §</a></h3>
<p>中文技术文档<strong>主要针对中文文本,应以中文标点符号为主,英文标点符号为辅。</strong></p>
<h3 id="基本规范">基本规范<a aria-hidden="true" tabindex="-1" href="#基本规范" class="internal"> §</a></h3>
<ol>
<li>在中文句子中使用英文单词或词组时:
<ul>
<li>使用的英文单词或词组不需要用中文引号包围。</li>
<li>如果使用的英文单词或词组本身有英文标点,保留其英文标点。</li>
<li>中文句子的末尾应使用中文标点符号。</li>
</ul>
</li>
<li>在中文句子中使用英文句子时:
<ul>
<li>应用中文引号包围英文句子。</li>
<li>如果英文句子本身有英文标点,保留其英文标点。</li>
<li>中文句子的末尾应使用中文标点符号。</li>
</ul>
</li>
</ol>
<table><thead><tr><th>标点符号</th><th>中文句子内夹用英文单词或词组时</th><th>中文句子内夹用英文句子时</th></tr></thead><tbody><tr><td>句号</td><td>change 和 transform 意义不同。</td><td>I like you.(我喜欢你。)</td></tr><tr><td>逗号</td><td>这个数据库的官方描述是“open-source, distributed SQL database”。</td><td>他们的官方文档上写着“Try it out, and you will get a 10% discount.”。</td></tr><tr><td>问号</td><td>distributed SQL 在这里是什么意思?</td><td>他伸出手说“Need a hand?”,这句话的含义是“你需要帮助吗?”?</td></tr><tr><td>叹号</td><td>不要总是对女孩说“Pretty!”!</td><td>他站在那感叹了句“What a beautiful scene!”。</td></tr><tr><td>顿号</td><td>be 动词包括 is、are、were、was 等。</td><td>“He is man.”、“He is a man.”和“He is the man。”三者的含义有何区别</td></tr><tr><td>分号</td><td>如果想表示更礼貌的语气,用 might反之用 may。</td><td>官方文档上说“To deploy the database, use the TiUP tool; to migrate data, use the DM tool.”。</td></tr><tr><td>冒号</td><td>官网有个首页按钮失效了Newsletter。</td><td>文档站的右上角写着Try it now。</td></tr><tr><td>引号</td><td>将来时态通常由“will + 动词原形”组成。</td><td>这篇文章里有句话比较难理解“The saint said, Follow your fear.’”。</td></tr><tr><td>破折号</td><td>这个符号表示禁止——stop。</td><td>“Well—emm, I dont know how to say—but I hope you can understand my position.”他纠结地说。</td></tr><tr><td>省略号</td><td>使用 so…that… 句型表示结果,意思是“如此……以至于……”。</td><td>“I dont know how to say this…”的含义是“我不知道该怎么说了……”。</td></tr></tbody></table>
<h4 id="中英文括号的使用">中英文括号的使用<a aria-hidden="true" tabindex="-1" href="#中英文括号的使用" class="internal"> §</a></h4>
<ul>
<li>括号里全为英文时建议使用半角括号,并在括号前后各空一个半角空格,括号和括号内的英文之间不需要空格。</li>
</ul>
<blockquote>
<p>数据定义语言DDL是一种……使用了全角括号
数据定义语言 (DDL) 是一种……(半角括号前后未空格)❌
数据定义语言□(□DDL□)□是一种……(半角括号和半角括号内的英文之间空了一格)❌</p>
<p>正确示例:数据定义语言□(DDL)□是一种……</p>
</blockquote>
<ul>
<li>括号里既有中文又有英文(即只要括号内包含任何中文)时建议使用全角括号,括号前后不空格。</li>
</ul>
<blockquote>
<p>斜杠 (slash 或 forward slash) 和反斜杠 (backslash) 是两种符号。❌</p>
<p>斜杠slash 或 forward slash和反斜杠 (backslash) 是两种符号。</p>
</blockquote>
<h4 id="英文书籍报刊标题的引用方法">英文书籍、报刊、标题的引用方法<a aria-hidden="true" tabindex="-1" href="#英文书籍报刊标题的引用方法" class="internal"> §</a></h4>
<ul>
<li>
<p>中文句子中夹用英文书籍或报刊名时,不能使用中文书名号《》,而应使用斜体字表示,如果无法使用斜体字,建议使用中文引号包裹引用。</p>
</li>
<li>
<p>英文文章的标题用中文引号包裹引用。</p>
</li>
</ul>
<blockquote>
<p><em>New York Times</em> 发布了一篇新文章标题是“Cloud is Eating the World”。</p>
</blockquote></article></div><div class="right sidebar"><div class="graph "><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:1,&quot;scale&quot;:1.1,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4
c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562
C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829
c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91
v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4
s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665
C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2
S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4
s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2
s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{&quot;drag&quot;:true,&quot;zoom&quot;:true,&quot;depth&quot;:-1,&quot;scale&quot;:0.9,&quot;repelForce&quot;:0.5,&quot;centerForce&quot;:0.3,&quot;linkDistance&quot;:30,&quot;fontSize&quot;:0.6,&quot;opacityScale&quot;:1,&quot;showTags&quot;:true,&quot;removeTags&quot;:[]}"></div></div></div><div class="toc desktop-only"><button type="button" id="toc" class><h3>Table of Contents</h3><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="fold"><polyline points="6 9 12 15 18 9"></polyline></svg></button><div id="toc-content"><ul class="overflow"><li class="depth-0"><a href="#常用中文标点符号" data-for="常用中文标点符号">常用中文标点符号</a></li><li class="depth-1"><a href="#句号" data-for="句号">句号「。」</a></li><li class="depth-1"><a href="#逗号" data-for="逗号">逗号「,」</a></li><li class="depth-1"><a href="#顿号" data-for="顿号">顿号「、」</a></li><li class="depth-1"><a href="#分号" data-for="分号">分号「;」</a></li><li class="depth-1"><a href="#冒号" data-for="冒号">冒号「:」</a></li><li class="depth-1"><a href="#引号--" data-for="引号--">引号「“ ”,‘ ’」</a></li><li class="depth-1"><a href="#括号" data-for="括号">括号「()」</a></li><li class="depth-1"><a href="#书名号" data-for="书名号">书名号「《》」</a></li><li class="depth-1"><a href="#连接号-" data-for="连接号-">连接号「-」</a></li><li class="depth-1"><a href="#破折号" data-for="破折号">破折号「——」</a></li><li class="depth-1"><a href="#省略号" data-for="省略号">省略号「……」</a></li><li class="depth-1"><a href="#感叹号" data-for="感叹号">感叹号「!」</a></li><li class="depth-1"><a href="#斜杠" data-for="斜杠">斜杠「/」</a></li><li class="depth-1"><a href="#反斜杠" data-for="反斜杠">反斜杠「\」</a></li><li class="depth-1"><a href="#反引号" data-for="反引号">反引号「`」</a></li><li class="depth-0"><a href="#中文标点使用" data-for="中文标点使用">中文标点使用</a></li><li class="depth-0"><a href="#中英文混用时的标点符号用法" data-for="中英文混用时的标点符号用法">中英文混用时的标点符号用法</a></li><li class="depth-1"><a href="#根本原则" data-for="根本原则">根本原则</a></li><li class="depth-1"><a href="#基本规范" data-for="基本规范">基本规范</a></li></ul></div></div><div class="backlinks "><h3>Backlinks</h3><ul class="overflow"><li>No backlinks found</li></ul></div><div class="explorer mobile-only"><button type="button" id="explorer" data-behavior="collapse" data-collapsed="collapsed" data-savestate="true" data-tree="[{&quot;path&quot;:&quot;Obsidian&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Obsidian/Templates&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2018&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2020&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2021&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2022&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2023&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Blog/2024&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Book&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Book/个人成长&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Book/医学健康&quot;,&quot;collapsed&quot;:true},{&quot;path&quot;:&quot;Personal/Book/历史&quot;,&quot;collapsed&quot;:true
function toggleCallout() {
const outerBlock = this.parentElement;
outerBlock.classList.toggle(`is-collapsed`);
const collapsed = outerBlock.classList.contains(`is-collapsed`);
const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight;
outerBlock.style.maxHeight = height + `px`;
let current = outerBlock;
let parent = outerBlock.parentElement;
while (parent) {
if (!parent.classList.contains(`callout`)) {
return;
}
const collapsed2 = parent.classList.contains(`is-collapsed`);
const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight;
parent.style.maxHeight = height2 + `px`;
current = parent;
parent = parent.parentElement;
}
}
function setupCallout() {
const collapsible = document.getElementsByClassName(
`callout is-collapsible`
);
for (const div of collapsible) {
const title = div.firstElementChild;
if (title) {
title.removeEventListener(`click`, toggleCallout);
title.addEventListener(`click`, toggleCallout);
const collapsed = div.classList.contains(`is-collapsed`);
const height = collapsed ? title.scrollHeight : div.scrollHeight;
div.style.maxHeight = height + `px`;
}
}
}
document.addEventListener(`nav`, setupCallout);
window.addEventListener(`resize`, setupCallout);
</script><script type="module">
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs';
const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark'
mermaid.initialize({
startOnLoad: false,
securityLevel: 'loose',
theme: darkMode ? 'dark' : 'default'
});
document.addEventListener('nav', async () => {
await mermaid.run({
querySelector: '.mermaid'
})
});
</script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="../../../postscript.js" type="module"></script></html>