mirror of
https://github.com/reonokiy/blog.nokiy.net.git
synced 2025-06-15 11:12:54 +02:00
chore: add i18n md style guide posts and an universal article
This commit is contained in:
radishzzz
parent
2b5c2b31ff
commit
f17710bf29
8 changed files with 945 additions and 33 deletions
|
|
@ -37,12 +37,12 @@ Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sap
|
|||
### Syntax
|
||||
|
||||
```markdown
|
||||
|
||||
|
||||
```
|
||||
|
||||
### Output
|
||||
|
||||
|
||||
|
||||
|
||||
## Blockquotes
|
||||
|
||||
|
|
@ -225,16 +225,3 @@ Press <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> to end the session.
|
|||
There is <del>nothing</del> no code either good or bad, but running it makes it so.
|
||||
|
||||
Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
|
||||
|
||||
<!-- <details>
|
||||
<summary>
|
||||
I have keys but no doors. I have space but no room. You can enter but can't
|
||||
leave. What am I?
|
||||
</summary>
|
||||
A keyboard.
|
||||
</details>
|
||||
|
||||
<figure>
|
||||
<img src="https://image.radishzz.cc/picsmaller/03.webp">
|
||||
<figcaption text-center="">Node Modules Inspector - Overview</figcaption>
|
||||
</figure> -->
|
||||
|
|
|
|||
227
src/content/posts/Markdown Style Guide-es.md
Normal file
227
src/content/posts/Markdown Style Guide-es.md
Normal file
|
|
@ -0,0 +1,227 @@
|
|||
---
|
||||
title: Guía de Estilo Markdown
|
||||
published: 2025-03-08
|
||||
updated: 2025-03-23
|
||||
tags: ["Guía"]
|
||||
pin: 1
|
||||
lang: es
|
||||
abbrlink: markdown-style-guide
|
||||
---
|
||||
|
||||
Aquí hay una muestra de sintaxis básica de Markdown que se puede utilizar al escribir contenido en Retypeset.
|
||||
|
||||
## Encabezados
|
||||
|
||||
Los siguientes elementos HTML `<h1>`—`<h6>` representan seis niveles de encabezados de sección. `<h1>` es el nivel de sección más alto mientras que `<h6>` es el más bajo.
|
||||
|
||||
# Encabezado 1
|
||||
|
||||
## Encabezado 2
|
||||
|
||||
### Encabezado 3
|
||||
|
||||
#### Encabezado 4
|
||||
|
||||
##### Encabezado 5
|
||||
|
||||
###### Encabezado 6
|
||||
|
||||
## Párrafo
|
||||
|
||||
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
|
||||
|
||||
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
|
||||
|
||||
## Imágenes
|
||||
|
||||
### Sintaxis
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
### Resultado
|
||||
|
||||
|
||||
|
||||
## Citas en bloque
|
||||
|
||||
El elemento de cita en bloque representa contenido citado de otra fuente, opcionalmente con una cita que debe estar dentro de un elemento `footer` o `cite`, y opcionalmente con cambios en línea como anotaciones y abreviaturas.
|
||||
|
||||
### Cita en bloque sin atribución
|
||||
|
||||
#### Sintaxis
|
||||
|
||||
```markdown
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.<br>
|
||||
> **Nota** que puedes usar _sintaxis Markdown_ dentro de una cita en bloque.
|
||||
```
|
||||
|
||||
#### Resultado
|
||||
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.<br>
|
||||
> **Nota** que puedes usar _sintaxis Markdown_ dentro de una cita en bloque.
|
||||
|
||||
### Cita en bloque con atribución
|
||||
|
||||
#### Sintaxis
|
||||
|
||||
```markdown
|
||||
> No te comuniques compartiendo memoria, comparte memoria comunicándote.<br>
|
||||
> — <cite>Rob Pike[^1]</cite>
|
||||
```
|
||||
|
||||
#### Resultado
|
||||
|
||||
> No te comuniques compartiendo memoria, comparte memoria comunicándote.<br>
|
||||
> — <cite>Rob Pike[^1]</cite>
|
||||
|
||||
[^1]: La cita anterior es un extracto de la [charla](https://www.youtube.com/watch?v=PAAkCSZUG1c) de Rob Pike durante Gopherfest, 18 de noviembre de 2015.
|
||||
|
||||
## Tablas
|
||||
|
||||
### Sintaxis
|
||||
|
||||
```markdown
|
||||
| Cursiva | Negrita | Código |
|
||||
| --------- | ----------- | -------- |
|
||||
| _cursiva_ | **negrita** | `código` |
|
||||
```
|
||||
|
||||
### Resultado
|
||||
|
||||
| Cursiva | Negrita | Código |
|
||||
| --------- | ----------- | -------- |
|
||||
| _cursiva_ | **negrita** | `código` |
|
||||
|
||||
## Bloques de Código
|
||||
|
||||
Podemos usar 3 comillas invertidas ``` en una nueva línea, escribir el fragmento y cerrar con 3 comillas invertidas en una nueva línea. Para resaltar la sintaxis específica del lenguaje, escriba una palabra del nombre del lenguaje después de las primeras 3 comillas invertidas, por ejemplo, html, javascript, css, markdown, typescript, txt, bash.
|
||||
|
||||
### Sintaxis
|
||||
|
||||
````markdown
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="es">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Ejemplo de Documento HTML5</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Prueba</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
````
|
||||
|
||||
### Resultado
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="es">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Ejemplo de Documento HTML5</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Prueba</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## Tipos de Listas
|
||||
|
||||
### Lista Ordenada
|
||||
|
||||
#### Sintaxis
|
||||
|
||||
```markdown
|
||||
1. Primer elemento
|
||||
2. Segundo elemento
|
||||
3. Tercer elemento
|
||||
```
|
||||
|
||||
#### Resultado
|
||||
|
||||
1. Primer elemento
|
||||
2. Segundo elemento
|
||||
3. Tercer elemento
|
||||
|
||||
### Lista No Ordenada
|
||||
|
||||
#### Sintaxis
|
||||
|
||||
```markdown
|
||||
- Elemento de lista
|
||||
- Otro elemento
|
||||
- Y otro elemento más
|
||||
```
|
||||
|
||||
#### Resultado
|
||||
|
||||
- Elemento de lista
|
||||
- Otro elemento
|
||||
- Y otro elemento más
|
||||
|
||||
### Lista Anidada
|
||||
|
||||
#### Sintaxis
|
||||
|
||||
```markdown
|
||||
- Frutas
|
||||
- Manzana
|
||||
- Naranja
|
||||
- Plátano
|
||||
- Lácteos
|
||||
- Leche
|
||||
- Queso
|
||||
```
|
||||
|
||||
#### Resultado
|
||||
|
||||
- Frutas
|
||||
- Manzana
|
||||
- Naranja
|
||||
- Plátano
|
||||
- Lácteos
|
||||
- Leche
|
||||
- Queso
|
||||
|
||||
## Otros Elementos
|
||||
|
||||
Incluyen superíndice `<sup>`, subíndice `<sub>`, abreviatura `<abbr>`, tachado `<del>`, subrayado ondulado `<u>`, entrada de teclado `<kbd>` y resaltado `<mark>`.
|
||||
|
||||
### Sintaxis
|
||||
|
||||
```markdown
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> es un formato de imagen de mapa de bits.
|
||||
|
||||
Los buenos escritores siempre revisan la <u title="ortografía">ortografia</u>.
|
||||
|
||||
Presiona <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Suprimir</kbd> para finalizar la sesión.
|
||||
|
||||
No hay <del>nada</del> ningún código que sea bueno o malo, pero ejecutarlo lo hace así.
|
||||
|
||||
La mayoría de las <mark>salamandras</mark> son nocturnas y cazan insectos, gusanos y otras criaturas pequeñas.
|
||||
```
|
||||
|
||||
### Resultado
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> es un formato de imagen de mapa de bits.
|
||||
|
||||
Los buenos escritores siempre revisan la <u title="ortografía">ortografia</u>.
|
||||
|
||||
Presiona <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Suprimir</kbd> para finalizar la sesión.
|
||||
|
||||
No hay <del>nada</del> ningún código que sea bueno o malo, pero ejecutarlo lo hace así.
|
||||
|
||||
La mayoría de las <mark>salamandras</mark> son nocturnas y cazan insectos, gusanos y otras criaturas pequeñas.
|
||||
227
src/content/posts/Markdown Style Guide-ja.md
Normal file
227
src/content/posts/Markdown Style Guide-ja.md
Normal file
|
|
@ -0,0 +1,227 @@
|
|||
---
|
||||
title: Markdown スタイルガイド
|
||||
published: 2025-03-08
|
||||
updated: 2025-03-23
|
||||
tags: ["ガイド"]
|
||||
pin: 1
|
||||
lang: ja
|
||||
abbrlink: markdown-style-guide
|
||||
---
|
||||
|
||||
以下は Retypeset テーマで使用できる基本的な Markdown 構文の例です。
|
||||
|
||||
## 見出し
|
||||
|
||||
HTML の `<h1>` から `<h6>` タグは6段階の見出しレベルに対応しています。`<h1>` が最高レベルの見出しで、`<h6>` が最低レベルです。
|
||||
|
||||
# 見出し 1
|
||||
|
||||
## 見出し 2
|
||||
|
||||
### 見出し 3
|
||||
|
||||
#### 見出し 4
|
||||
|
||||
##### 見出し 5
|
||||
|
||||
###### 見出し 6
|
||||
|
||||
## 段落
|
||||
|
||||
孔乙己が店に入ると、酒を飲んでいた人々は皆彼を見て笑い、中には「孔乙己、顔にまた新しい傷ができたな！」と声をかける者もいた。彼は答えず、店の主人に「お酒を二杯温めて、茴香豆を一皿」と言い、九文の銭を出した。彼らはまた意図的に大声で「また人の物を盗んだに違いない！」と言った。孔乙己は目を大きく開いて「どうして人の清白を無実に汚すのか…」「何が清白だ？一昨日、何家の本を盗んで、吊るされて叩かれたのを見たぞ」と言われると、孔乙己は顔を赤くし、額の青筋が浮き上がり、「書を盗むのは盗みとは言えない…書を盗む！…読書人の行いが、どうして盗みと言えようか？」と反論し、続いて「君子固窮」や「者乎」などの難解な言葉を並べ立て、人々を大笑いさせた。店内外は陽気な空気に満ちていた。
|
||||
|
||||
人々の裏話によると、孔乙己はもともと勉強していたが、結局科挙に合格せず、生計を立てる方法も知らなかった。そのため、だんだん貧しくなり、ついには物乞いをしなければならなくなった。
|
||||
|
||||
## 画像
|
||||
|
||||
### 構文
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
### 出力
|
||||
|
||||
|
||||
|
||||
## 引用ブロック
|
||||
|
||||
引用ブロック要素は他のソースから引用したコンテンツを表し、オプションで `footer` または `cite` 要素内に引用元を含めることができます。また、引用ブロック内で `<mark>`、`<abbr>` などのタグを使用することもできます。
|
||||
|
||||
### 出典のない引用ブロック
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
> 天地不仁、以万物為芻狗。<br>
|
||||
> **注意**：引用ブロック内でも _Markdown 構文_ が使えます。
|
||||
```
|
||||
|
||||
#### 出力
|
||||
|
||||
> 天地不仁、以万物為芻狗。<br>
|
||||
> **注意**：引用ブロック内でも _Markdown 構文_ が使えます。
|
||||
|
||||
### 出典付きの引用ブロック
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。<br>
|
||||
> —— <cite>『秋の夜』[^1]</cite>
|
||||
```
|
||||
|
||||
#### 出力
|
||||
|
||||
> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。<br>
|
||||
> —— <cite>『秋の夜』[^1]</cite>
|
||||
|
||||
[^1]: [『秋の夜』](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85))は魯迅の散文詩集『野草』の最初の散文詩で、1924年に書かれました。
|
||||
|
||||
## 表
|
||||
|
||||
### 構文
|
||||
|
||||
```markdown
|
||||
| イタリック体 | 太字 | コード |
|
||||
| ---------- | ------- | ------- |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
```
|
||||
|
||||
### 出力
|
||||
|
||||
| イタリック体 | 太字 | コード |
|
||||
| ---------- | ------- | ------- |
|
||||
| _イタリック_ | **太字** | `コード` |
|
||||
|
||||
## コードブロック
|
||||
|
||||
コードの前後に3つのバッククォート ``` を追加してコードブロックを作成します。最初のバッククォートの後に言語タイプ（html、javascript、css、markdownなど）を指定することで、構文ハイライトを実現できます。
|
||||
|
||||
### 構文
|
||||
|
||||
````markdown
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="ja">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>HTML5 サンプル文書</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>テスト</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
````
|
||||
|
||||
### 出力
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="ja">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>HTML5 サンプル文書</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>テスト</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## リスト
|
||||
|
||||
### 順序付きリスト
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
1. 最初の項目
|
||||
2. 2番目の項目
|
||||
3. 3番目の項目
|
||||
```
|
||||
|
||||
#### 出力
|
||||
|
||||
1. 最初の項目
|
||||
2. 2番目の項目
|
||||
3. 3番目の項目
|
||||
|
||||
### 順序なしリスト
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
- リスト項目
|
||||
- 別の項目
|
||||
- さらに別の項目
|
||||
```
|
||||
|
||||
#### 出力
|
||||
|
||||
- リスト項目
|
||||
- 別の項目
|
||||
- さらに別の項目
|
||||
|
||||
### ネストされたリスト
|
||||
|
||||
#### 構文
|
||||
|
||||
```markdown
|
||||
- フルーツ
|
||||
- リンゴ
|
||||
- オレンジ
|
||||
- バナナ
|
||||
- 野菜
|
||||
- 青菜
|
||||
- 大根
|
||||
```
|
||||
|
||||
#### 出力
|
||||
|
||||
- フルーツ
|
||||
- リンゴ
|
||||
- オレンジ
|
||||
- バナナ
|
||||
- 野菜
|
||||
- 青菜
|
||||
- 大根
|
||||
|
||||
## その他の要素
|
||||
|
||||
`<sup>` 上付き文字、`<sub>` 下付き文字、`<abbr>` 略語、`<del>` 取り消し線、`<u>` 波線、`<kbd>` キーボード入力、`<mark>` ハイライトなどが含まれます。
|
||||
|
||||
### 構文
|
||||
|
||||
```markdown
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> はビットマップ画像形式の一種です。
|
||||
|
||||
書物は人類の進歩の<del>階段</del>梯子です。
|
||||
|
||||
優れた作家は常に<u title="スペリング">つづり</u>の間違いをチェックします。
|
||||
|
||||
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> を押してセッションを終了します。
|
||||
|
||||
ほとんどの<mark>サンショウウオ</mark>は夜行性で、昆虫や虫などの小さな生き物を捕食します。
|
||||
```
|
||||
|
||||
### 出力
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> はビットマップ画像形式の一種です。
|
||||
|
||||
書物は人類の進歩の<del>階段</del>梯子です。
|
||||
|
||||
優れた作家は常に<u title="スペリング">つづり</u>の間違いをチェックします。
|
||||
|
||||
<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> を押してセッションを終了します。
|
||||
|
||||
ほとんどの<mark>サンショウウオ</mark>は夜行性で、昆虫や虫などの小さな生き物を捕食します。
|
||||
227
src/content/posts/Markdown Style Guide-ru.md
Normal file
227
src/content/posts/Markdown Style Guide-ru.md
Normal file
|
|
@ -0,0 +1,227 @@
|
|||
---
|
||||
title: Руководство по стилю Markdown
|
||||
published: 2025-03-08
|
||||
updated: 2025-03-23
|
||||
tags: ["Руководство"]
|
||||
pin: 1
|
||||
lang: ru
|
||||
abbrlink: markdown-style-guide
|
||||
---
|
||||
|
||||
Вот примеры базового синтаксиса Markdown, который можно использовать при написании контента в Retypeset.
|
||||
|
||||
## Заголовки
|
||||
|
||||
Следующие HTML-элементы `<h1>`—`<h6>` представляют шесть уровней заголовков разделов. `<h1>` — самый высокий уровень раздела, а `<h6>` — самый низкий.
|
||||
|
||||
# Заголовок 1
|
||||
|
||||
## Заголовок 2
|
||||
|
||||
### Заголовок 3
|
||||
|
||||
#### Заголовок 4
|
||||
|
||||
##### Заголовок 5
|
||||
|
||||
###### Заголовок 6
|
||||
|
||||
## Абзац
|
||||
|
||||
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
|
||||
|
||||
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
|
||||
|
||||
## Изображения
|
||||
|
||||
### Синтаксис
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
### Результат
|
||||
|
||||
|
||||
|
||||
## Цитаты
|
||||
|
||||
Элемент цитирования представляет контент, цитируемый из другого источника, с возможным указанием источника внутри элемента `footer` или `cite`, а также с возможными встроенными изменениями, такими как аннотации и сокращения.
|
||||
|
||||
### Цитата без указания авторства
|
||||
|
||||
#### Синтаксис
|
||||
|
||||
```markdown
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.<br>
|
||||
> **Обратите внимание**, что внутри цитаты можно использовать _синтаксис Markdown_.
|
||||
```
|
||||
|
||||
#### Результат
|
||||
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.<br>
|
||||
> **Обратите внимание**, что внутри цитаты можно использовать _синтаксис Markdown_.
|
||||
|
||||
### Цитата с указанием авторства
|
||||
|
||||
#### Синтаксис
|
||||
|
||||
```markdown
|
||||
> Не общайтесь путем совместного использования памяти, а делитесь памятью через общение.<br>
|
||||
> — <cite>Роб Пайк[^1]</cite>
|
||||
```
|
||||
|
||||
#### Результат
|
||||
|
||||
> Не общайтесь путем совместного использования памяти, а делитесь памятью через общение.<br>
|
||||
> — <cite>Роб Пайк[^1]</cite>
|
||||
|
||||
[^1]: Приведенная выше цитата взята из [выступления](https://www.youtube.com/watch?v=PAAkCSZUG1c) Роба Пайка на Gopherfest 18 ноября 2015 года.
|
||||
|
||||
## Таблицы
|
||||
|
||||
### Синтаксис
|
||||
|
||||
```markdown
|
||||
| Курсив | Жирный | Код |
|
||||
| -------- | ---------- | ----- |
|
||||
| _курсив_ | **жирный** | `код` |
|
||||
```
|
||||
|
||||
### Результат
|
||||
|
||||
| Курсив | Жирный | Код |
|
||||
| -------- | ---------- | ----- |
|
||||
| _курсив_ | **жирный** | `код` |
|
||||
|
||||
## Блоки кода
|
||||
|
||||
Мы можем использовать 3 обратные кавычки ``` в новой строке, написать фрагмент кода и закрыть 3 обратными кавычками в новой строке. Для подсветки синтаксиса конкретного языка укажите название языка после первых 3 обратных кавычек, например: html, javascript, css, markdown, typescript, txt, bash.
|
||||
|
||||
### Синтаксис
|
||||
|
||||
````markdown
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="ru">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Пример документа HTML5</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Тест</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
````
|
||||
|
||||
### Результат
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="ru">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Пример документа HTML5</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Тест</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## Типы списков
|
||||
|
||||
### Упорядоченный список
|
||||
|
||||
#### Синтаксис
|
||||
|
||||
```markdown
|
||||
1. Первый пункт
|
||||
2. Второй пункт
|
||||
3. Третий пункт
|
||||
```
|
||||
|
||||
#### Результат
|
||||
|
||||
1. Первый пункт
|
||||
2. Второй пункт
|
||||
3. Третий пункт
|
||||
|
||||
### Неупорядоченный список
|
||||
|
||||
#### Синтаксис
|
||||
|
||||
```markdown
|
||||
- Пункт списка
|
||||
- Еще один пункт
|
||||
- И еще один пункт
|
||||
```
|
||||
|
||||
#### Результат
|
||||
|
||||
- Пункт списка
|
||||
- Еще один пункт
|
||||
- И еще один пункт
|
||||
|
||||
### Вложенный список
|
||||
|
||||
#### Синтаксис
|
||||
|
||||
```markdown
|
||||
- Фрукты
|
||||
- Яблоко
|
||||
- Апельсин
|
||||
- Банан
|
||||
- Молочные продукты
|
||||
- Молоко
|
||||
- Сыр
|
||||
```
|
||||
|
||||
#### Результат
|
||||
|
||||
- Фрукты
|
||||
- Яблоко
|
||||
- Апельсин
|
||||
- Банан
|
||||
- Молочные продукты
|
||||
- Молоко
|
||||
- Сыр
|
||||
|
||||
## Другие элементы
|
||||
|
||||
Включая верхний индекс `<sup>`, нижний индекс `<sub>`, аббревиатуру `<abbr>`, зачеркнутый текст `<del>`, волнистое подчеркивание `<u>`, ввод с клавиатуры `<kbd>` и выделение `<mark>`.
|
||||
|
||||
### Синтаксис
|
||||
|
||||
```markdown
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> — это формат растровых изображений.
|
||||
|
||||
Хорошие писатели всегда проверяют <u title="правописание">правописание</u>.
|
||||
|
||||
Нажмите <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd>, чтобы завершить сеанс.
|
||||
|
||||
Нет <del>ничего</del> ни хорошего, ни плохого кода, но запуск делает его таковым.
|
||||
|
||||
Большинство <mark>саламандр</mark> ведут ночной образ жизни и охотятся на насекомых, червей и других мелких существ.
|
||||
```
|
||||
|
||||
### Результат
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> — это формат растровых изображений.
|
||||
|
||||
Хорошие писатели всегда проверяют <u title="правописание">правописание</u>.
|
||||
|
||||
Нажмите <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd>, чтобы завершить сеанс.
|
||||
|
||||
Нет <del>ничего</del> ни хорошего, ни плохого кода, но запуск делает его таковым.
|
||||
|
||||
Большинство <mark>саламандр</mark> ведут ночной образ жизни и охотятся на насекомых, червей и других мелких существ.
|
||||
227
src/content/posts/Markdown Style Guide-zh-tw.md
Normal file
227
src/content/posts/Markdown Style Guide-zh-tw.md
Normal file
|
|
@ -0,0 +1,227 @@
|
|||
---
|
||||
title: Markdown 樣式指南
|
||||
published: 2025-03-08
|
||||
updated: 2025-03-23
|
||||
tags: ["指南"]
|
||||
pin: 1
|
||||
lang: zh-tw
|
||||
abbrlink: markdown-style-guide
|
||||
---
|
||||
|
||||
以下是一些基本的 Markdown 語法示例，可以在 Retypeset 主題中使用。
|
||||
|
||||
## 標題
|
||||
|
||||
HTML 的 `<h1>` 至 `<h6>` 標籤對應六個等級的標題。`<h1>` 為最高級標題，`<h6>` 為最低級。
|
||||
|
||||
# 一級標題
|
||||
|
||||
## 二級標題
|
||||
|
||||
### 三級標題
|
||||
|
||||
#### 四級標題
|
||||
|
||||
##### 五級標題
|
||||
|
||||
###### 六級標題
|
||||
|
||||
## 段落
|
||||
|
||||
孔乙己一到店，所有喝酒的人便都看著他笑，有的叫道："孔乙己，你臉上又添上新傷疤了！"他不回答，對櫃裡說："溫兩碗酒，要一碟茴香豆。"便排出九文大錢。他們又故意的高聲嚷道："你一定又偷了人家的東西了！"孔乙己睜大眼睛說："你怎麼這樣憑空污人清白……""什麼清白？我前天親眼見你偷了何家的書，吊著打。"孔乙己便漲紅了臉，額上的青筋條條綻出，爭辯道："竊書不能算偷……竊書！……讀書人的事，能算偷麼？"接連便是難懂的話，什麼"君子固窮"，什麼"者乎"之類，引得眾人都哄笑起來：店內外充滿了快活的空氣。
|
||||
|
||||
聽人家背地裡談論，孔乙己原來也讀過書，但終於沒有進學，又不會營生；於是愈過愈窮，弄到將要討飯了。
|
||||
|
||||
## 圖片
|
||||
|
||||
### 語法
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
### 效果
|
||||
|
||||
|
||||
|
||||
## 區塊引用
|
||||
|
||||
區塊引用標籤表示從外部引用的內容，可以使用 `footer` 或 `cite` 標籤標註內容來源，也可以在區塊引用中使用 `<mark>`、`<abbr>` 等標籤。
|
||||
|
||||
### 未標註內容來源
|
||||
|
||||
#### 語法
|
||||
|
||||
```markdown
|
||||
> 天地不仁，以萬物為芻狗。<br>
|
||||
> **提示**：引用區塊內可使用 _Markdown 語法_。
|
||||
```
|
||||
|
||||
#### 效果
|
||||
|
||||
> 天地不仁，以萬物為芻狗。<br>
|
||||
> **提示**：引用區塊內可使用 _Markdown 語法_。
|
||||
|
||||
### 標註內容來源
|
||||
|
||||
#### 語法
|
||||
|
||||
```markdown
|
||||
> 在我的後園，可以看見牆外有兩株樹，一株是棗樹，還有一株也是棗樹。<br>
|
||||
> —— <cite>《秋夜》[^1]</cite>
|
||||
```
|
||||
|
||||
#### 效果
|
||||
|
||||
> 在我的後園，可以看見牆外有兩株樹，一株是棗樹，還有一株也是棗樹。<br>
|
||||
> —— <cite>《秋夜》[^1]</cite>
|
||||
|
||||
[^1]: [《秋夜》](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85)) 是魯迅散文詩集《野草》中的第一首散文詩，創作於1924年。
|
||||
|
||||
## 表格
|
||||
|
||||
### 語法
|
||||
|
||||
```markdown
|
||||
| 斜體 | 粗體 | 程式碼 |
|
||||
| ------- | -------- | ------- |
|
||||
| _斜體_ | **粗體** | `程式碼` |
|
||||
```
|
||||
|
||||
### 效果
|
||||
|
||||
| 斜體 | 粗體 | 程式碼 |
|
||||
| ------- | -------- | ------- |
|
||||
| _斜體_ | **粗體** | `程式碼` |
|
||||
|
||||
## 程式碼區塊
|
||||
|
||||
在程式碼的開頭和結尾處，添加三個反引號 ``` 來創建程式碼區塊。在開頭的反引號後標註語言類型，例如 html、javascript、css、markdown 等，以實現語法高亮效果。
|
||||
|
||||
### 語法
|
||||
|
||||
````markdown
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="zh-TW">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>HTML5 示例文檔</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>測試</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
````
|
||||
|
||||
### 效果
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="zh-TW">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>HTML5 示例文檔</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>測試</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## 列表
|
||||
|
||||
### 有序列表
|
||||
|
||||
#### 語法
|
||||
|
||||
```markdown
|
||||
1. 第一項
|
||||
2. 第二項
|
||||
3. 第三項
|
||||
```
|
||||
|
||||
#### 效果
|
||||
|
||||
1. 第一項
|
||||
2. 第二項
|
||||
3. 第三項
|
||||
|
||||
### 無序列表
|
||||
|
||||
#### 語法
|
||||
|
||||
```markdown
|
||||
- 列表項
|
||||
- 另一項
|
||||
- 更多項
|
||||
```
|
||||
|
||||
#### 效果
|
||||
|
||||
- 列表項
|
||||
- 另一項
|
||||
- 更多項
|
||||
|
||||
### 嵌套列表
|
||||
|
||||
#### 語法
|
||||
|
||||
```markdown
|
||||
- 水果
|
||||
- 蘋果
|
||||
- 橙子
|
||||
- 香蕉
|
||||
- 蔬菜
|
||||
- 青菜
|
||||
- 蘿蔔
|
||||
```
|
||||
|
||||
#### 效果
|
||||
|
||||
- 水果
|
||||
- 蘋果
|
||||
- 橙子
|
||||
- 香蕉
|
||||
- 蔬菜
|
||||
- 青菜
|
||||
- 蘿蔔
|
||||
|
||||
## 其他元素
|
||||
|
||||
包括 `<sup>` 上標，`<sub>` 下標，`<abbr>` 縮寫，`<del>` 刪除線，`<u>` 波浪線，`<kbd>` 鍵盤輸入，`<mark>` 高亮。
|
||||
|
||||
### 語法
|
||||
|
||||
```markdown
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> 是一種點陣圖圖像格式。
|
||||
|
||||
書籍是人類進步的<del>樓梯</del>階梯。
|
||||
|
||||
優秀的作者總是會仔細檢查<u title="拼">拚</u>寫錯誤。
|
||||
|
||||
按下 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> 以結束會話。
|
||||
|
||||
大多數<mark>蠑螈</mark>晝伏夜出，以昆蟲、蠕蟲等小生物為食。
|
||||
```
|
||||
|
||||
### 效果
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> 是一種點陣圖圖像格式。
|
||||
|
||||
書籍是人類進步的<del>樓梯</del>階梯。
|
||||
|
||||
優秀的作家總是會仔細檢查<u title="拼寫">拚寫</u>問題。
|
||||
|
||||
按下 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> 以結束會話。
|
||||
|
||||
大多數<mark>蠑螈</mark>晝伏夜出，以昆蟲、蠕蟲等小生物為食。
|
||||
|
|
@ -34,8 +34,6 @@ HTML 的 `<h1>` 至 `<h6>` 标签对应六个等级的标题。`<h1>` 为最高
|
|||
|
||||
## 图片
|
||||
|
||||
使用相对路径 `../assets/image.jpg` 或绝对路径 `https://example.com/image.jpg` 来引用图片。
|
||||
|
||||
### 语法
|
||||
|
||||
```markdown
|
||||
|
|
@ -44,7 +42,7 @@ HTML 的 `<h1>` 至 `<h6>` 标签对应六个等级的标题。`<h1>` 为最高
|
|||
|
||||
### 效果
|
||||
|
||||
|
||||
|
||||
|
||||
## 块引用
|
||||
|
||||
|
|
|
|||
25
src/content/posts/Universal Article.md
Normal file
25
src/content/posts/Universal Article.md
Normal file
|
|
@ -0,0 +1,25 @@
|
|||
---
|
||||
title: 通用文章 Universal Article
|
||||
published: 2025-03-24
|
||||
lang: ''
|
||||
---
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: 通用文章 Universal Article
|
||||
published: 2025-03-24
|
||||
# lang: ''
|
||||
---
|
||||
```
|
||||
|
||||
这是一篇未指定 lang 的多语言通用文章，默认显示在所有语言路径下。
|
||||
|
||||
這是一篇未指定 lang 的多語言通用文章，預設顯示於所有語言路徑下。
|
||||
|
||||
これは言語パラメータ（lang）未指定の汎用マルチリンガル記事です。全言語パスでデフォルト表示されます。
|
||||
|
||||
This is a universal multilingual article with unspecified 'lang', displayed by default across all language-specific paths.
|
||||
|
||||
Este es un artículo universal multilingüe sin definir 'lang', visible por defecto en todas las rutas de idiomas.
|
||||
|
||||
Это универсальная многоязычная статья без указания 'lang', отображаемая по умолчанию во всех языковых разделах.
|
||||
|
|
@ -8,8 +8,7 @@
|
|||
.heti {
|
||||
--at-apply: 'leading-1.5em break-words hyphens-auto tracking-0.02em';
|
||||
}
|
||||
.heti:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti:not(:lang(zh)) {
|
||||
.heti:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)) {
|
||||
--at-apply: 'tracking-0';
|
||||
}
|
||||
|
||||
|
|
@ -28,8 +27,7 @@
|
|||
.heti p {
|
||||
--at-apply: 'mt-3 mb-4 text-justify';
|
||||
}
|
||||
.heti p:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti p:not(:lang(zh)) {
|
||||
.heti p:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)) {
|
||||
--at-apply: 'text-start';
|
||||
}
|
||||
|
||||
|
|
@ -66,11 +64,8 @@
|
|||
--at-apply: 'tracking-0.05em';
|
||||
}
|
||||
.heti h1:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti h1:not(:lang(zh)),
|
||||
.heti h2:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti h2:not(:lang(zh)),
|
||||
.heti h3:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti h3:not(:lang(zh)) {
|
||||
.heti h3:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)) {
|
||||
--at-apply: 'tracking-0';
|
||||
}
|
||||
.heti h1 + h2,
|
||||
|
|
@ -95,7 +90,7 @@
|
|||
|
||||
/* Code Blocks */
|
||||
.heti pre {
|
||||
--at-apply: 'my-3 px-4 py-3 rounded bg-secondary/5! border border-solid border-secondary/7';
|
||||
--at-apply: 'mt-3 mb-4 px-4 py-3 rounded bg-secondary/5! border border-solid border-secondary/7';
|
||||
--at-apply: 'overflow-auto whitespace-pre scrollbar-hidden';
|
||||
}
|
||||
.heti pre code {
|
||||
|
|
@ -220,19 +215,19 @@ html.dark .heti mark {
|
|||
content: "腳註";
|
||||
--at-apply: 'block text-5 font-semibold mt-6 mb-3';
|
||||
}
|
||||
.footnotes:lang(ja-JP)::before {
|
||||
.footnotes:lang(ja)::before {
|
||||
content: "脚注";
|
||||
--at-apply: 'block text-5 font-semibold mt-6 mb-3';
|
||||
}
|
||||
.footnotes:lang(en-US)::before {
|
||||
.footnotes:lang(en)::before {
|
||||
content: "Footnotes";
|
||||
--at-apply: 'block text-5 font-semibold mt-6 mb-3';
|
||||
}
|
||||
.footnotes:lang(es-ES)::before {
|
||||
.footnotes:lang(es)::before {
|
||||
content: "Notas al pie";
|
||||
--at-apply: 'block text-5 font-semibold mt-6 mb-3';
|
||||
}
|
||||
.footnotes:lang(ru-RU)::before {
|
||||
.footnotes:lang(ru)::before {
|
||||
content: "Сноски";
|
||||
--at-apply: 'block text-5 font-semibold mt-6 mb-3';
|
||||
}
|
||||
|
|
@ -260,8 +255,7 @@ html.dark .heti mark {
|
|||
.heti q {
|
||||
quotes: "「" "」" "『" "』";
|
||||
}
|
||||
.heti q:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)),
|
||||
.heti q:not(:lang(zh)) {
|
||||
.heti q:not(:lang(zh)):not(:lang(ja)):not(:lang(ko)) {
|
||||
quotes: initial;
|
||||
quotes: auto;
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue