@tenjuu99/blog 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +52 -82
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# blog
|
|
1
|
+
# @tenjuu99/blog
|
|
2
2
|
|
|
3
3
|
## setup
|
|
4
4
|
|
|
@@ -15,111 +15,81 @@ npx server
|
|
|
15
15
|
|
|
16
16
|
## 記事を書く
|
|
17
17
|
|
|
18
|
-
`./
|
|
18
|
+
`./src/pages/` 以下にマークダウンファイルを入稿します。
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
`
|
|
22
|
-
`url` は出力先になります。
|
|
23
|
-
`published` は index ファイルがソートするのに利用します。
|
|
20
|
+
とりあえずなにも設定せずに、内容は空のままで構わないので `src/pages/test.md` を追加してみます。
|
|
21
|
+
`src/pages/test.md` を保存したら、 `http://localhost:8000/test` にアクセスして表示できていることを確認します。
|
|
24
22
|
|
|
25
|
-
|
|
23
|
+
次に、内容を記述します。
|
|
24
|
+
`src/pages/test.md` を次のような内容で保存します。
|
|
26
25
|
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
title: sample article
|
|
30
|
-
url: /sample_article
|
|
31
|
-
published: 2024/03/18 00:00
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
トップレベル見出しは `title` 変数が利用されます。
|
|
35
|
-
変えたい場合は template/default.html を修正してください。
|
|
26
|
+
```
|
|
27
|
+
# 第一章 人情の碗
|
|
36
28
|
|
|
37
|
-
|
|
29
|
+
茶は薬用として始まり後飲料となる。シナにおいては八世紀に高雅な遊びの一つとして詩歌の域に達した。十五世紀に至り日本はこれを高めて一種の審美的宗教、すなわち茶道にまで進めた。茶道は日常生活の俗事の中に存する美しきものを崇拝することに基づく一種の儀式であって、純粋と調和、相互愛の神秘、社会秩序のローマン主義を諄々と教えるものでる。茶道の要義は「不完全なもの」を崇拝するにある。いわゆる人生というこの不可解なもののうちに、何か可能なものを成就しようとするやさしい企てであるから。
|
|
30
|
+
```
|
|
38
31
|
|
|
39
|
-
|
|
32
|
+
保存したら、 `http://localhost:8000/test` をリロードして表示を確認しましょう。
|
|
40
33
|
|
|
41
|
-
##
|
|
34
|
+
## タイトルとURL
|
|
42
35
|
|
|
43
|
-
|
|
36
|
+
ファイル冒頭を `---` でくくると変数を指定できます。
|
|
44
37
|
|
|
45
|
-
|
|
46
|
-
[アンカーテキストはこちら](http://example.com)
|
|
38
|
+
`src/pages/test.md` の冒頭に次のような変数を設定してみましょう。
|
|
47
39
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
40
|
+
```markdown
|
|
41
|
+
---
|
|
42
|
+
title: 第一章 人情の碗
|
|
43
|
+
url: /the_book_of_tea/section_one
|
|
44
|
+
---
|
|
45
|
+
```
|
|
52
46
|
|
|
53
|
-
|
|
47
|
+
`http://localhost:8000/test` ではアクセスできず、 `http://localhost:8000/the_book_of_tea/section_one` でアクセスできるようになったとおもいます。
|
|
54
48
|
|
|
55
|
-
|
|
56
|
-
|
|
49
|
+
ここで定義した変数は、テンプレート内でも利用できます。
|
|
50
|
+
次のように書き換えてみます。
|
|
57
51
|
|
|
58
|
-
|
|
59
52
|
|
|
60
|
-
|
|
53
|
+
```markdown
|
|
54
|
+
---
|
|
55
|
+
title: 第一章 人情の碗
|
|
56
|
+
url: /the_book_of_tea/section_one
|
|
57
|
+
---
|
|
61
58
|
|
|
62
|
-
|
|
59
|
+
# {{title}}
|
|
63
60
|
|
|
64
|
-
|
|
65
|
-
return (new Date()).toString()
|
|
66
|
-
{/script}
|
|
61
|
+
茶は薬用として始まり後飲料となる。シナにおいては八世紀に高雅な遊びの一つとして詩歌の域に達した。十五世紀に至り日本はこれを高めて一種の審美的宗教、すなわち茶道にまで進めた。茶道は日常生活の俗事の中に存する美しきものを崇拝することに基づく一種の儀式であって、純粋と調和、相互愛の神秘、社会秩序のローマン主義を諄々と教えるものでる。茶道の要義は「不完全なもの」を崇拝するにある。いわゆる人生というこの不可解なもののうちに、何か可能なものを成就しようとするやさしい企てであるから。
|
|
67
62
|
```
|
|
68
63
|
|
|
69
|
-
|
|
64
|
+
URLの変更は、変数による定義ではなく、ファイルを移動しても問題ありません。
|
|
65
|
+
`src/pages/test.md` を `src/pages/the_book_of_tea/section_one.md` としてファイルを移動すれば、変数定義がなくてもこのURLになります。
|
|
70
66
|
|
|
71
|
-
##
|
|
67
|
+
## テンプレート
|
|
72
68
|
|
|
73
|
-
|
|
69
|
+
タイトルが重複して表示されて鬱陶しいので、テンプレートを編集します。
|
|
74
70
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
```markdown
|
|
78
|
-
---
|
|
79
|
-
foo: fooVariableContent
|
|
80
|
-
bar: varVariableContent
|
|
81
|
-
---
|
|
82
|
-
```
|
|
71
|
+
`src/template/default.html` を開き、h1 を削除しましょう。
|
|
83
72
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
<!DOCTYPE html>
|
|
88
|
-
<html lang="en">
|
|
89
|
-
<head>
|
|
90
|
-
<meta charset="UTF-8">
|
|
91
|
-
<title></title>
|
|
92
|
-
</head>
|
|
93
|
-
<body>
|
|
94
|
-
{{foo}}
|
|
95
|
-
{{bar}}
|
|
96
|
-
</body>
|
|
97
|
-
</html>
|
|
73
|
+
```diff
|
|
74
|
+
<article class="container">
|
|
75
|
+
- <h1>{{TITLE}}</h1>
|
|
98
76
|
```
|
|
99
77
|
|
|
100
|
-
|
|
78
|
+
## 設定ファイル
|
|
101
79
|
|
|
102
|
-
|
|
80
|
+
サイト全体の名称がデフォルトのままでは味気ないので変えましょう。
|
|
81
|
+
blog.json を開いて、 `site_name` を変更します。
|
|
103
82
|
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
This content will be removed.
|
|
114
|
-
{else}
|
|
115
|
-
This is else content.
|
|
116
|
-
{/if}
|
|
83
|
+
```json
|
|
84
|
+
{
|
|
85
|
+
"site_name": "茶の本",
|
|
86
|
+
"url_base": "http://localhost:8000",
|
|
87
|
+
"src_dir": "src",
|
|
88
|
+
"dist_dir": "dist",
|
|
89
|
+
"distribute_raw": "image",
|
|
90
|
+
"helper": "helper/index.js"
|
|
91
|
+
}
|
|
117
92
|
```
|
|
118
93
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
```markdown
|
|
122
|
-
<script type="ssg">
|
|
123
|
-
return 'これはスクリプトが実行された結果出力されました。'
|
|
124
|
-
</script>
|
|
125
|
-
```
|
|
94
|
+
設定ファイルを変更したら、一旦 `CTRL+c` で `npx server` を停止して、もういちど `npx server` を実行します。
|
|
95
|
+
ヘッダーが「茶の本」になっていたら設定更新が完了です。
|