-
Notifications
You must be signed in to change notification settings - Fork 0
/
07-writing.re
303 lines (176 loc) · 28.8 KB
/
07-writing.re
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
= å·çç°å¢
//flushright{
erukiti/äœã
æšä¿ä»
//}
DTP(DeskTop Publishing)ãšåŒã°ãããã®ãäžè¬åããçŸä»£ãã²ãšãŸãå·çç°å¢ãšããŠã¯ã³ã³ãã¥ãŒã¿ã䜿ã£ããã®ãåæãšããŠãã®ç« ã§ã¯è²ã
玹ä»ããŠã¿ãŸãã
身ããµãããªãããšãèšã£ãŠããŸããšãã©ããªããŒã«ã䜿ãããšãPDFãåºåã§ããã°ãªããåé¡ãããŸããã
== DTPããŒã«ã䜿ã
ãœããäžã§æåãã€ã©ã¹ãã䞊ã¹ãŠäœæ¥ããããããœãããåºãæå³ã§DTPãœãããšåŒç§°ããããšãã§ããŸããããã䜿ã£ãŠããDTPãœãããšããã°ãAdobe InDesignãæ¥çæšæºã§ããããŸãæè¡å人èªã§ã¯åºçªãç¡ãããç¥ããŸããããAdobe InDesign ã䜿ãã°åã£ãæ¬ãäœæã§ããã§ãããã
ãŸããæè¡æžãæžãå Žåãã¯ãŒãããœããããã®ãŸãŸDTPãœããã«ãªããŸãããããã£ãŠãMicrosoft Wordã䜿ããšãæ軜ã«å人èªãæžããŸããWordã¯ããããŠãã®(Windowsã®ããžãã¹/ããŒã çšã®)PCã«ã€ã³ã¹ããŒã«ãããŠããããæ¥åžžçã«äœ¿ãããšãããã§ãããããããšãããã䜿ãæ¹ã«å°ãããšã¯å°ãªãããšæããŸããããããæå³ã§ãåããŠæè¡æžãæžãå Žåã®å·çããŒã«ãšããŠã¯Bestãªéžæã§ãã䜿ãæ¹ã§è¿·ãåã«æ¬æãæžãäžããŠããŸããŸãããããªããå¹ççã«æžããªããã©ãŒããããããŸãããããšããã§ããAppendix Cã«æè¡æžãæžãå Žåã®Wordã®äœ¿ãæ¹ãšãã»ã³ã¹ããããŸãã®ã§ãã¡ããåç
§ããããšãããããããŸãã
ãŸããã¯ãŒãããœãããšããŠæåãªäžå€ªéããããæ°å¹Žã¯å人èªå·çå±€ãåã蟌ã¿ã«ããã£ãŠããŸããææ°ã®äžå€ªéã§ã¯ãäž»èŠãªå°å·æã®ãã©ãŒãããã«åãããpdfããããªãåºåã§ããæ©èœãè¿œå ãããããã§ãã
ããŠãDTPããŒã«ã䜿ãå Žåããããªããã®ãœããã§æžãå§ãããããããã¹ããšãã£ã¿ã§æ¬æãæžããŠããããã®ãœããã«æµã蟌ã¿ãå³ã貌ãä»ããããåç
§é¢ä¿ã調æŽãããã»ãã楜ã«æžããã®ã§ã¯ãªãããšçè
ã¯æããŠããŸãããŸãã¯çŽ°ãã䜿ãåæã«å·Šå³ãããã®ã§ã¯ãªããæç« ã®å
容ãæ§æãäœã蟌ãæ¹ã«éäžãããšè¯ããšæããŸãããã£ãã5å²ãã8å²ãããã®åéãæžããŸã§ã¯ããã¹ããšãã£ã¿ã§ååã ãšèããŸãã
ãŸããè€æ°äººã§æžãå ŽåãGoogleDocãªã©ã䜿ãã®ãæå¹ã§ããå
šãåãéšåãåæç·šéããããšã¯å°ãªãã®ã§ãæå³ããªãå€æŽã競åãèµ·ããããšã¯å°ãªããç°å¢æ§ç¯äžèŠã§ãå°å·ãããšãã®èŠãç®ã«ããªãè¿ãå·çç°å¢ãæã«å
¥ããããšãã§ããŸãã
== ããã¹ããã¡ã€ã«ãã³ã³ãã€ã«ããç³»ã®ççµããŒã«ã䜿ã
ãªãããã®ããã¹ããšãã£ã¿ã䜿ã£ãŠæžãããœãŒã¹ã³ãŒããã³ã³ãã€ã«ããŠææç©ãåŸããšããã®ã¯ãœãããŠã§ã¢æè¡è
ã«ãšã£ãŠã¯ãªãã¿æ·±ããšæããŸããæè¡æžå
žã§åºãããŠããæ¬ã®å€ãã¯ãããã£ãææ³ã䜿ãããŠããŸãã
* Re:VIEW
* Markdown
* HTML+CSS
* Sphinx
* TeX/LaTeX
ã ãããããããžãã人æ°ãããšããã§ããããããããããæ¬æãæžããŠãç»åã®è²Œãä»ããäœè£ã«é¢ããåœä»€ãéã«ã¯ãã¿ãã³ã³ãã€ã«ãããšpdfãªã©ã®å
¥çš¿å¯èœãªãã¡ã€ã«ãåºåãããŸãã
=== Re:VIEW
Re:VIEW@<fn>{Re:VIEW}ã¯çŸæç¹ã§ã¯kmuto@<fn>{kmuto}ãããäžå¿ã«40人以äžã®éçºè
ãåå ãããªãŒãã³ãœãŒã¹ãªçµã¿çãœããã§ããå®éã«ããã€ãã®åºç瀟ãæ¡çšããŠãããããŠãŒã¹ã®ãœããã§ãããæè¡ç³»å人èªã§ããã䜿ããããªã©ããããã¢ããã¥ã¢ã䜿ããšãŠã䟿å©ãªãœããã§ãã
//footnote[Re:VIEW][@<href>{http://reviewml.org/}]
//footnote[kmuto][@<href>{https://github.com/kmuto}]
æè¡ç³»å人èªã§ãã䜿ãããã®ã¯ãæè¡å人èªã®å€§å®¶ã§ããTechBoosterããããã®ããŠããŠãæãã¿ãªãè©°ã蟌ãã ãªããžããªãå
¬éããŠãããããç°å¢ããæ§ç¯ã§ããã°ããã®ãŸãŸæžãå§ãããããšããå©ç¹ãããããã§ãã
* @<href>{https://github.com/TechBooster/ReVIEW-Template}
* @<href>{https://github.com/TechBooster/C89-FirstStepReVIEW-v2}
åŸè
ã¯å®éã«ã³ãã±C89ã§è²©å£²ãããŠãããæè¡æžããããïŒãã¯ãããŠã®Re:VIEWãæ¹èšçããšããæ¬ã®ãœãŒã¹ã³ãŒãã«è©²åœããŸãã
å®ã¯ãæ¬æžã®å人èªããŒãžã§ã³ãGitHubã§ãã¹ãŠå
¬éãããŠããŸããhttps://github.com/onestop-techbook/c93-onestop-techbookãšãããªããžããªããæ¬æžã®å人èªããŒãžã§ã³ã®ãœãŒã¹ã³ãŒããªã®ã§ããç°å¢ãæŽããã°ãå人èªçã®PDFãepubãçæã§ããŸããæ¬æžã¯ã@<tt>{ReVIEW-Template}ãããŒã¹ã«æžãããŠããŸãã
* @<href>{https://github.com/onestop-techbook/c93-onestop-techbook}
Re:VIEWã§ã¯ãã±ã¢ã¹ããŒ(åœæ)ã§äœ¿ãããŠããç»æçãªé»ååºçã·ã¹ãã ãEWBïŒEditor's Work BenchïŒãã®æžåŒãããŒã¹ã«ãã€ã€ç°¡æåããèšè¿°æ¹æ³ã§æ¬ãæžããŸããMarkdownãä»ã®Wikiãšã¯éãå°ãçãããããã«æããããèšæ³ã§ãããçµã¿çã«ç¹åããŠããŠå¿
èŠååãªæ©èœãæã£ãŠããŸãã
ãããŸãã«åããŠãè¡åäœã®åœä»€ãšæç« ã®äžã«å
¥ããã€ã³ã©ã€ã³åœä»€ã§æ§æãããŠããŸãã
//listnum[list-test][ãªã¹ãã®ãã¹ã]{
#@mapfile(sample/01-writing/hoge.re)
= Re:View ã¯ãããªæãã§ãããŸãã㌠ã®ç«
== ã»ããŒ
ãµããŒ@<code>{@}<fn>{fuga}
//footnote[fuga][ãµããŒ]
ãŽããŒ
@<code>{#@#} ã³ã¡ã³ã
#@end
//}
#@# ãªã¹ãã®äžã§ãRe:Viewã®ã€ã³ã©ã€ã³åœä»€ã解éããŠããŸãã®ã§èŠæ³šæ
#@# #@ ã§å§ãŸãè¡ã«é¢ããŠããããªããã»ããµã®éœåãããã®ã§ããããªæãã«
ããšãã°@<list>{list-test}ã¯å®éã®Re:VIEWã®ãœãŒã¹ã³ãŒãã§ãã
ãã£ãšç¥ããããã°ã@<href>{https://github.com/onestop-techbook/c93-onestop-techbook} ãéããŠã¿ãŠãã ãããæ¬æžã®åçš¿ã¯Re:VIEWã§æžãããŠã㊠Github ã§å
¬éãããŠããŸããRubyãšTeXããæºåã§ããã°ãæ¬æžããã®ãŸãŸã³ã³ãã€ã«ããŠPDFãçæã§ããŸãã
@<code>{=} ã§å§ãŸãè¡ã¯èŠåºãã§ããç¹ã«@<code>{=}ã®ãããªã€ã³ãŒã«èšå·ã1ã€ã®ãã®ã¯ç« ã§ãã
* @<code>{=} ç«
* @<code>{==} ç¯
* @<code>{===} é
* @<code>{====} 段
* @<code>{=====} å°æ®µ
@<code>{//} ã§å§ãŸãè¡ã¯ãããã¯åœä»€ã§ãã
@<code>{@}<code>{fuga}ã®ãããªåœä»€ã¯ã€ã³ã©ã€ã³åœä»€ã§ãã
詳ããã¯å
¬åŒWiki@<fn>{format-ja}ãã芧ãã ããã
//footnote[format-ja][@<href>{https://github.com/kmuto/review/blob/master/doc/format.ja.md}]
Re:VIEWã®æžåŒã®è©³çŽ°ã«ã€ããŠã¯ãAppendixãã芧ãã ããã
====[column]æ瀺çã«ç©ºè¡ãå
¥ããæ¹æ³ïŒèŠªæ¹
Re:VIEWã§ã¯ã2è¡ä»¥äžã®ç©ºè¡ã¯ç¡èŠãããŸããæ¹è¡ã¯brã§å
¥ããããã®ã§ãããããšããéšåã§èè
ããšã®ã³ã¡ã³ããæ瀺çã«åºåãããå Žåã«å°ããŸããã
æé»ã®å宣èšãããããæ¹è¡ãå
šè§ã¹ããŒã¹ãæ¹è¡ãšãããšããããããšããã³ã¡ã³ããè²°ããŸããã
ã
å
šè§ã¹ããŒã¹ã®ã¿ã®æ®µèœãã§ããŸãã®ã§ãå®è³ªçã«ç©ºè¡ãå
¥ããŸãããªãã»ã©ãªãã»ã©ã
ãŸããéæUpdateãããŠããŸãã®ã§ãæ°ããæ©èœãææ³ãè¿œå ãããŠããŸããææ°ã®å®è£
ã¯æ¬å®¶ã確èªãã ããã
å®éãã€ã®éã«ããâ//blanklineâ ãšããæ©èœãè¿œå ãããŸããã2018幎é ãRe:VIEW Ver2.5 ã§å®è£
ãããããã§ãããããã£ãŠãæåã®å人çã§ã¯ãå
šè§ã¹ããŒã¹ãšããBadKnowHowã䜿ã£ãŠããŸãããã»ã»ã»
ããããBadKnowHowã ã£ãŠèšé²ããŠããããšã«æå³ãããã§ããããããæ®ããŠãããŸãããã
====[/column]
=== Markdown
Markdownã¯æè¡è
åãã®ç°¡æèšèªã§ãããæ軜ãã€ãçµ±äžãã©ãŒããããšããŠã®åŽé¢ããããGithubã§äœ¿ããGFMïŒGithub Fravored Markdown@<fn>{GFM}ïŒãäºå®äžã®æšæºãšãªã£ãŠããŸãã
//footnote[GFM][@<href>{https://github.github.com/gfm/}]
ããã°ãããã¥ã¡ã³ããMarkdownã§æžãããããã¬ãŒã³ã®ã¹ã©ã€ããMarkdownã§äœæãããªã©ããããã䜿ããæ¹ã§ãããMarkdownã§ãæè¡æžãå·çã§ããŸãã
md2review@<fn>{md2review}ã䜿ãã°ãMarkdownã§æžããæ¬ãRe:VIEWãçµç±ããŠé«å質ãªPDFãªã©ãäœæã§ããŸãã
//footnote[md2review][@<href>{https://github.com/takahashim/md2review}]
ãŸããmd2inao@<fn>{md2inao}ã䜿ãã°ãMarkdownã§æžããæç« ãInDesignã«åã蟌ããããã«å€æã§ããŸãã
//footnote[md2inao][@<href>{https://github.com/naoya/md2inao}]
Gitbook@<fn>{gitbook}ãšãããMarkdownã§å·çã§ããããŒã«ããããŸããRe:VIEWã»ã©ã®é«å質ã§ã¯ãããŸããããããã§ãååå人èªãäœæã§ããå質ãã€ãRe:VIEWããã¯éãã«æ¥œã§ãã
//footnote[gitbook][@<href>{https://github.com/GitbookIO/gitbook}]
=== VivliostyleïŒHTML/Markdown+CSSçµç)
é»åæžç±ã®ãã©ãŒããããšããŠæšæºãšãªã£ãŠããEPub圢åŒã§ãããå®è³ªHTML+CSSã§ããé 匵ã£ãŠCSSã§ããŸãè£
食ããã°ãå°å·ããŠå人èªã«ããããšãã§ããŸãã
VivlioStyleãšããçµçã·ã¹ãã ããããæè¿ç²Ÿåçã«æŽ»åãããŠããããã§ããèå³ããæ¹ã¯ãã²ã®ãããŠã¿ãŠãã ããã
https://vivliostyle.org/ja/
MarkdownãŸãã¯HTMLãšCSSããPDFãEPUBãåºåããããšãã§ããé©åãªãã³ãã¬ãŒãã䜿ãã°å°å·å¯èœãªPDFãçæããããšãã§ããŸãã
Vivliostyle CLIã¯ã³ãã³ãã©ã€ã³ããPDFãæžãåºãããšãã§ãããŸãè±å¯ãªäœæäŸããããŸãã
VivliostyleãŠãŒã¶ãŒäŒã®ã¿ãªããããVivliostyleã§æ¬ãäœããããšããã·ãªãŒãºã§Vivliostyleã䜿ã£ãæ¬ãå®æçã«çºè¡ããŠããŸãããªããªããã®ãã³ãã¬ãŒãããã®ãŸãŸäœ¿ãã°ãããªãå°å·çšã®PDFãçæããããšãã§ããŸããïŒ
=== reSTïŒSphinxïŒ
Markdownããã¯è¥å¹²ãã€ããŒã§ããreSTãšããèšè¿°åœ¢åŒããããSphinxãšããããŒã«ã䜿ããšããæããããŸããSphinx@<fn>{sphinx}ã¯Pythonã®å
¬åŒããã¥ã¡ã³ããäœãããã«çãŸãããã®ã§ãããããã§å人èªãäœæãã§ããŸããreST圢åŒã«ã€ããŠã¯reStructuredTextå
¥é@<fn>{reST}ãèªããšããã§ãããã
//footnote[sphinx][@<href>{http://docs.sphinx-users.jp/}]
//footnote[reST][@<href>{http://docs.sphinx-users.jp/rest.html}]
=== TeX/LaTex
ãã£ãšãTeXãå¿ãã¡ããããŸãããRe:VIEWã¯TeXã®ããã³ããšã³ãã§ãããè£ã§ã¯TeXãèµ°ã£ãŠããŸãããäžæ¹ã§æ¬å®¶TeXã¯ãäœæ³ã¯ã ãã¶è€éã§ããæ
å ±ç³»ãæ°åŠç³»ãå·¥åŠç³»ã®äººã¯äžåºŠã¯è§Šã£ãããšãããããšæããŸããâŠäœ¿ãæ
£ããªããšãªããªãé£ããããã§ããèªç±åºŠãé«ããæ°åŒã¯ç¢ºãã«ãããã«æžããŸããããããæã«TeXãå§ãããããšããã®ã¯ããŸãããããã§ããŸãããæžãå§ãããã®ã®ãéäžã§ããã£ãŠããŸããèå¿ã®å·çãæ¢ãŸã£ãŠããŸããšãããªã¹ã¯ããããŸããããçšåºŠTeXã«æ
£ããŠãã人ã«ãšã£ãŠã¯ããããªãTeXã§æžãããšãååã«éžæè¢ãšããŠèæ
®ããŠããã§ãããã
ãªããæ°åŒãå€çšããå Žåãããã埮åç©åããããã¯çŽ¯ä¹ãæ·»åãé£ã³äº€ããããªæç« ããã®ä»ã®æ°åŠèšå·ãæ»ããŠãããããªæç« ãæžãå Žåã¯éžæè¢ã«å
¥ãã§ãããã
ãªããããã³ããšã³ããšããŠãLyX@<fn>{LyX}ã䜿ããšããã®ã¯è¯ãéžæã§ããTeXã®ããŸããªããããªã軜æžãããŠããŠãã¯ãŒãããœããïŒDTPãœãããšããŠããªã䜿ãåæãè¯ããªããŸãã
//footnote[LyX][@<href>{https://www.lyx.org/WebJa.Home}]
== ããã¹ãããŒã¹ã®å·çç°å¢ã§äœ¿ããã®
ããŠãã¯ãŒãããDTPãœãããŠãšã¢ã䜿ããªãå Žåãã©ããã£ãŠããã¹ããå·çãã¹ãã§ããããïŒ
ãã®æ¬ã§ã¯GithubãšRe:VIEWã䞻軞ãšããŠå·çããŠããŸãããšã³ãžãã¢ã«éŠŽæã¿ãããå€äººæ°ã§ã®å·çã«åããŠããŸã@<fn>{solo}ãæè¡æžå
žã§åºå±ãããŠããå人èªã§ã¯ããèŠãããæ§æã§ãããŸãã¯å·çç°å¢ã®æŠèŠã説æããŸãã
//footnote[solo][ãã¡ããå人ã®å·çã«ãåããŠããŸãã]
=== ããŒãžã§ã³ç®¡çã·ã¹ãã
Gitããã³GitHubã䜿ããšãããŒãžã§ã³ç®¡çã¯ãšãŠã楜ã«ãªããŸãã
äžäººã§æžãå Žåããæ¬æžã®ããã«è€æ°äººã§æžãå Žåããããã¹ãããŒã¹ã®å·çã®å ŽåãããŒãžã§ã³ç®¡çããã¹ãŠGitã«ä»»ããŠããŸãã®ã¯ãšãŠãè¯ãéžæã§ãã
Gitã¯ãšã³ãžãã¢ããã£ãšããã䜿ã£ãŠããããŒãžã§ã³ç®¡çããŒã«ã§ããLinux ã®äœè
Linus Benedict Torvald æ°ããLinux ã®éçºã«èãã倧èŠæš¡ããŒãžã§ã³ç®¡çããŒã«ãç¡ãããšã«ããåããŠéçºãããã®ã§ããGit ãã以å㯠Subversion ãšãããœããããã䜿ãããŠããŸããããå§åçã« git ã®æ¹ã䜿ãåæããããã£ãšããéã«æ®åããŸããã
Gitã®ããšããã£ã±ãããããªããšãã人ã¯ãããã°ã¡ãããšåŠã¶ Git䜿ãæ¹å
¥é@<fn>{wakaba}ããªã¹ã¹ã¡ããŸãã
//footnote[wakaba][@<href>{https://www.amazon.co.jp/dp/B071D4D6XX/}]
ããŒãžã§ã³ç®¡çããŒã«ãšããã®ã¯ããããã£ã±ã«ãããšãœãŒã¹ã³ãŒããã¿ã€ã ãã·ã³çã«ããã¯ã¢ããããŠç®¡çãããã®ã§ãããããå±¥æŽãšãããŸãããgitã§ã¯å±¥æŽã®å·®åãçã¹ããŒã¹ã§ä¿æããä»çµã¿ãªã®ã§ã容éãæ°ã«ãããœãŒã¹ã³ãŒãã®å±¥æŽãæ®ããŸãã
====[column] ãã¡ã€ã«ç®¡çãã·ã¹ãã åããå©ç¹
Windowsã䜿ã£ãŠããŠã@<tt>{ã¹ã±ãžã¥ãŒã«.backup.ããŒãžã§ã³1.ææ°ç.old.txt}ã®ãããªãã¡ã€ã«ãèŠãããããšã¯ãããŸãããïŒãã¡ã€ã«ãã³ããŒããŠãã¡ã€ã«åã§å±¥æŽç®¡çããããšããé¥ãçœ ã§ããã©ããææ°ãªã®ãããããªããšããåé¡ããããŸããã§ã¯ã解決æ¹æ³ãšããŠ@<tt>{ã¹ã±ãžã¥ãŒã«.2017-11-11.txt}ãšããåœåã«ãŒã«ã§çžãããšããŠã¿ãŸãããã®å ŽåæŽæ°é »åºŠãäžæ¥äžåã«ãããŸãã°ããã§ãããåãæ¥ã«æŽæ°ããããšããå Žåããã«ã«ãŒã«ãå¿
èŠã«ãªããŸããããšãã°@<tt>{ã¹ã±ãžã¥ãŒã«.2017-11-11.01.txt}ã§ããããã§ãããåæã«å¥ã
ã®äººãæŽæ°ããããšããå Žåã«ã¯ã©ããªãã§ããããïŒããã«ããã¡ãã¡äººéãæã§æ¥ä»ãããã®é¢åãããªãã§ããïŒ
ããã§ããŒãžã§ã³ç®¡çããŒã«ã§ããããšãã°Gitã§ããã®ãªãã°ãgitã«@<tt>{ã¹ã±ãžã¥ãŒã«.txt}ãç»é²ããã ãã§ããã³ããããšããäœæ¥ãããã ãã§åæã«ãœãŒã¹ã³ãŒã貯èµåº«ïŒãªããžããªïŒã«ä¿ç®¡ãããŸãããã€ã®æç¹ã®@<tt>{ã¹ã±ãžã¥ãŒã«.txt}ãæ¢ãåºããŸãããã°åç
§ã»ã°ã©ãåç
§ã»æ€çŽ¢ãªã©ããŸããŸãªæ¹æ³ã§æ¥œãã€é«éã§æ¢ãåºããŸãã
ãã¡ã€ã«åã§ç®¡çãããšããåå§çãªããšãããæ代ã§ã¯ãªããªã£ãã®ã§ãã
ãã㊠GitHub@<fn>{github} 㯠git ã掻çšããäžçæ倧ã®ãœãŒã¹ã³ãŒã SNS ã§ããšã³ãžãã¢ã«ãšã£ãŠã¯ååºä»£ãããšãã£ãŠããããã®ã§ãããšã³ãžãã¢ã«ãšã£ãŠã®æåçæšæºã§ããããŸããããšãã°ãMarkdown ãšåŒã°ããæç« ã®ç°¡æèšæ³ã¯ãGitHub ã® MarkdownïŒGithub Fravored MarkdownïŒãäºå®äžã®æšæºãšãªã£ãŠããŸãããgit ããšã³ãžãã¢ã®æšæºã«ãªã£ãã®ããGithub ã®ååšããšãŠã倧ããã®ã§ãã
//footnote[github][@<href>{https://github.com/}]
GitHub ã¯å€äººæ°ã§ãœãŒã¹ã³ãŒããåæéçºããã®ã«ãšãŠãåããŠãã䟿å©ãªãµãŒãã¹ã§ããå¥ã«ãœãŒã¹ã³ãŒããšãã£ãŠãããã°ã©ãã³ã°ã«éå®ããå¿
èŠã¯ãããŸãããæ¬ã®åçš¿ããœãŒã¹ã³ãŒãã§ãããã®ãœãŒã¹ã³ãŒãã GitHub ã«é ããã®ã§ããèªåã® PC ãå¹ã£é£ãã§ã GitHub ã«ãœãŒã¹ã³ãŒãã眮ããŠãéãæ²åããå¿
èŠã¯ãããŸãã@<fn>{local-commit}ã
//footnote[local-commit][ããŒã«ã«ã§ã®å€æŽç¹ã GitHub ã«éã£ãŠãªããšãã¯ããã¡ããæ²ããããšã«ãªããŸã]
====[/column]
====[column] SNS ãšããŠã® GitHub
SNS ãšããã° Twitter ã Facebook ãæåã§ãããGitHub ãã³ãã¥ãã±ãŒã·ã§ã³æ©èœãè±å¯ã§ãã
issueïŒã€ã·ã¥ãŒïŒã¯ãã®ãããžã§ã¯ãã«ãããåé¡ã話åãæ²ç€ºæ¿ã®ãããªãã®ã§ããissue ã¯ãã»ã©ã®ããšãç¡ãéã誰ã§ãæžããŸãããœãããŠã§ã¢ã«å¯Ÿãããã°å ±åã»è³ªåãå¯ããããããããŒã å
ã§ã®èšèšè°è«ãªãããè¡ãããŠããŸãã
Pull-RequestïŒPR / ãã«ãªã¯ïŒã¯ GitHub ã®äžçªã®ç¹åŸŽãšãããããã®ã§ããããæå㪠OSS@<fn>{OSS} ã®ãããžã§ã¯ãããã£ããšããŠãããªãããã°ãèŠã€ãããšããŸãããã®ãšã issue ã§å ±åããã®ãæã§ãããããªãèªèº«ããã°ãçŽããŠãããåæ ãããã°æã£åãæ©ããããŸãããïŒãããããã®ããã«ãªã¯ã§ãããããªããã«ãªã¯åäœãæãããšå°æããããããããªãã®ã§ãissue ã§åé¡æèµ·ãã€ã€ãããããããããªãã°ããã£ãããçŽãããããšèšã£ãŠäžç·ã«ãã«ãªã¯ãæããã°ããã£ãšããªãã¯ããŒããŒã«ãªããã§ãããã
//footnote[OSS][ãªãŒãã³ãœãŒã¹ãœãããŠã§ã¢ã®ç¥ã§ã誰ã§ãèªç±ã«ãœãŒã¹ã³ãŒããèªãã ãæ¹å€ã§ãããœãããŠã§ã¢ã§ããOSSã®ç»å Žã«ãã£ãŠããœãããŠã§ã¢éçºã®äžçã¯äžæ°ã«æžãæãããŸããã]
ä»ã«ããããžã§ã¯ãçšã® Wiki ãé²æ管çããŒã«ãªã©ãå
å
ããŠããŠããšã³ãžãã¢ã«ãšã£ãŠ GitHub ã¯ææŸããªãã®ã§ãã
====[/column]
=== Docker
Docker ã¯ããããã ãªLinuxå®è¡ç°å¢ãã³ã³ãããšããç¬ç«ãã空éã«éã蟌ããŠå®è¡ãããã®ã§ããDocker ã«ã€ããŠè©³ããèªãåºããšã€ã³ãã©ã®æ¬äžåæžããã®ã§è©³ããã¯èª¬æããŸããããDockerfile ãšãããã¡ã€ã«ããçšæããŠããã°ãWindows ã§ã Mac ã§ã Linux ã§ããåã Linux ã³ã³ãããåããŸãããããŠå¹žããªããšã« Re:VIEW é¢é£å
šãŠãã€ã³ã¹ããŒã«ããã Dockerfile ãå
¬éãããŠãã@<fn>{vvakame}ã®ã§ãããã䜿ãã ãã§Re:VIEWç°å¢ãæ§ç¯ã§ããŸãã
//footnote[vvakame][https://github.com/vvakame/docker-review]
Dockerã¯Windowsç°å¢ã ãšçãããããšèšãããŠããŸããããæšä»å€§å¹
ã«æ¹åããŸããããŸãMacãLinuxç°å¢ãªãåãããããã§ãããããããŠãDockerã®å©ç¹ã¯ãã¯ã©ãŠãã®ãµãŒãã¹ã§åããããããšããã®ããããŸããããŒã«ã«ã®ç°å¢ãšã¯ã©ãŠãã®ç°å¢ãåäžãã·ãŒã ã¬ã¹ã«ããããšãå¯èœã§ãã次ã«èª¬æããWercerCIã¯ãŸãã«ãã®æ§è³ªã掻çšããŠããŸãã
=== Wercker
Re:VIEW ã§æžãããå皿㯠PDF ã epub ãªã©ã®åœ¢åŒãšããŠåºåïŒã³ã³ãã€ã«ïŒããªããšæ¬ã«ã¯ãªããŸãããã€ã³ã¹ããŒã«ããã¡ãããšããŠããã° Re:VIEW ã®ã³ã³ãã€ã«ã¯ç°¡åã§ãããããŒã ã§å·çããå Žåãããããã®äººã®ç°å¢ã«å·Šå³ãããã«ã³ã³ãã€ã«ã§ããæ¹ã楜ã§ãããšãã«ããã¯èªååããŠãããããã®ã§ããGitHub ã«ç»é²ãããåçš¿ãèªåã§ã³ã³ãã€ã«ãã㊠PDF ãªã©ã«å€æãããŠããã°æé«ã§ãããããããããŒã¿ã®åºåã ããããããŸãããèªåã§æ ¡æ£ããããŒã«ããããŸãããããã£ãããŒã«ã§ããã®åçš¿ã¡ãã£ãšããºããã§ã¯ïŒããšããææãå
šèªåã§åºãããšãç°¡åã§ãã
èªåã§ã³ã³ãã€ã«ããããšããé¡ããå¶ããŠãããã®ã CIïŒContinuous Integration@<fn>{CI}ïŒãšãããGitHub ãšé£åããŠããã CI ã®ãµãŒãã¹ãäœçš®é¡ããããŸããèªåã§ãµãŒããŒãç«ãŠãå¿
èŠã¯ãããŸããããŠãŒã¶ãŒç»é²ããŠãç°¡åãªèšå®ãããã ãã§ããæè¿ã¯ãªããžããªã«èšå®ãã¡ã€ã«ã1ã€è¿œå ããŠãGitHub é£åã®èšå®ãããã ããšãããæ軜㪠CI ãµãŒãã¹ãäž»æµã§ãã
ããŠãä»å説æããã®ã¯ Wercker@<fn>{wercker} ãšãããµãŒãã¹ã§ãããã®ãµãŒãã¹ã¯å
ã
ã¹ã¿ãŒãã¢ãããšããŠã¯ããŸã£ããã®ã§ãåŸã« Oracle@<fn>{Oracle} 瀟ã«è²·åãããŸãããçµå¶ããŠããäŒç€Ÿã¯ãšããããšããŠãWercker ã¯äœ¿ãããããèšå®ã®ç°¡åãã売ãã§ããä»ã® CI ãµãŒãã¹ã§ã¯ãªã¬ãªã¬ã«ãŒã«ãç解ããªããšäœ¿ããªããã®ããããŸãããWercker ã§ã¯ Docker ããç解ããŠããã°ã»ãšãã©ãªã¬ãªã¬ã«ãŒã«ãæèããå¿
èŠã¯ãããŸããã
//footnote[CI][æ¥æ¬èªã§ã¯ç¶ç¶çã€ã³ãã°ã¬ãŒã·ã§ã³ãšãããèªåã§ã³ã³ãã€ã«ããŠããããã¹ããèµ°ããããã®ã§ããšã³ãžãã¢ã®çç£æ§ãæ¯ãããã®ã§ãããã®ãžã£ã³ã«ã§ã¯Jenkinsãæåã§ããGUIã§èšå®ããªããã°ãããªãJenkinsã¯æè¿ã§ã¯æ¬é ãããåŸåããããŸãã]
//footnote[wercker][@<href>{http://www.wercker.com/}]
//footnote[Oracle][ãªã©ã¯ã«ãšèããšã€ãã€ã身æ§ãã人ããããããããŸããããWercker ã¯ãšãŠããããµãŒãã¹ã§ãã]
ä»ã«ãCircleCIãªã©æåãªCIãµãŒãã¹ã¯ããã€ããããŸãããDockerã«å¯Ÿå¿ããŠãããµãŒãã¹ãæãŸããã§ããããã»ã©ã軜ã説æãããšãããRe:VIEWã®ç°å¢æŽå㯠Docker ãããã°ç°¡åãªããã§ãã
@<href>{https://app.wercker.com/onestop-techbook/c93-onestop-techbook/runs}ã¯æ¬æžã®å人çãã³ã³ãã€ã«ããWercker CIã®çµæ衚瀺ããŒãžã§ãã
泚ïŒwerckerã¯2022幎10ææ«ããã£ãŠãµãŒãã¹çµäºããããšã«ãªããŸãããä»ã®CIãµãŒãã¹ã«ãããŠã倧差ã¯ãªãã§ããããããæ¬æžã®èšè¿°ã¯æ®ããŸãããä»ã®ãµãŒãã¹ã䜿ãããã«ã¯ãå¿
èŠã«å¿ããŠé©å®èªã¿æ¿ããŠãã ããã
=== ããã¹ããšãã£ã¿
ããã¹ããšãã£ã¿ãäœã䜿ã£ãŠããŸããïŒWindowsã®ã¡ã¢åž³ã§é 匵ã£ãŠã匷è
ãªã²ãšãããã£ããããããããŸãããVim ã Emacs ãšããæãªããã®ãšãã£ã¿ããããŸããããšã³ãžãã¢ã«äººæ°ã®ããã¹ããšãã£ã¿ãšãããšãæè¿ã¯ããã¢ãã³ãª Atom@<fn>{atom} ã Visual Studio Code@<fn>{vscode} ããããŸãã
äžã§ãVisual Studio CodeïŒVSCodeïŒã¯ååã®éã Visual Studio ãªã®ã§ããã¹ããšãã£ã¿ãšãããã㯠IDE ãªã®ã§ãããšãŠã軜éã§ããã¹ããšãã£ã¿ãšããŠããšãŠã䜿ãåæãè¯ããæè¿ã·ã§ã¢ãæ¥æ¿ã«äŒžã°ããŠããŸããå®éãæ¬æžãå¥ã®æ¬ããRe:VIEW ãã©ã°ã€ã³ãã€ã³ã¹ããŒã«ãã VSCode ã§æžããŠããŸããçè
ãè©Šããéãã ãš Atom ããåäœã軜éãã€ãJavaScript/TypeScript ã§ã® IDE ãšããŠã®æ©èœãçè
ã«ãšã£ãŠã®å¿
èŠååãªã®ã§ãæçšããŠãããšãã£ã¿ã§ãã
Markdown ã§å·çããå Žåã¯ãMarkdown å°éã®ããŒã«ã䜿ããšããæããããŸããWindows ã§ã Mac ã§ãæè¿ã¯ãããã㪠Markdown å·çããŒã«ãããã®ã§ãããããå©çšããŠã¿ããšããæããããŸããæè¿ã¯ãŠã§ããµãŒãã¹ã§ Markdown 圢åŒããµããŒãããŠããã±ãŒã¹ãå€ããããã°ãæžãããããã®ã«ã䟿å©ã§ããMarkdownãšãã£ã¿ãšãã£ã圢ã§æ€çŽ¢ããã°ããã€ããããããŸãã䜿ãæ
£ãããã®ãç¥ã£ãŠããã®ãããã°ããã䜿ã£ãŠå·çããŸãããã
//footnote[vscode][@<href>{https://code.visualstudio.com/}]
//footnote[atom][@<href>{https://atom.io/}ããã ãæè¿ã¯VSCodeã«æŒããã2022幎æ«ã§éçºçµäºããããã§ãã]
== ç°å¢æ§ç¯
Re:VIEWãæå
ã§åããã«ã¯æäœéRubyãå¿
èŠã«ãªããŸãããã㊠PDF ãåºåããå Žå㯠LaTeX ãå¿
èŠã«ãªããŸããMac ã Linux ã ãšãããªãã«ããŠããŠãå€ãããçšåºŠæ¥œã§ãããWindows ã§ç°å¢ãæŽããå Žåã¯ããªãé¢åã§ããWindows10 ã® Windows Subsystem for Linux ã䜿ãããšå€§åãã·ã§ãããã ãã©ã®ç°å¢ã«ãããLaTeX ã¯ãšã«ããè²ã
ãšé¢åã§ããDocker ã䜿ããã«èªåã§ç°å¢æ§ç¯ããããªããããªãã®èª¿æ»ãšç 究ãå¿
èŠã«ãªãã§ãããã
* Rubyãã€ã³ã¹ããŒã«ããïŒRe:VIEWãRubyã§äœãããŠããããïŒ
* PDFå€æãããããã« LaTeX ãã€ã³ã¹ããŒã«ãã
* Re:VIEWãã€ã³ã¹ããŒã«ãã
ãŸããæ¬æžã®ãªããžããªã§ã¯JavaScriptã䜿ãããŠããããNode.jsããããšããã§ãããã
=== Dockerãã€ã³ã¹ããŒã«ãã
Docker for Windows@<fn>{docker-for-windows} ã Docker for Mac@<fn>{docker-for-mac}ã䜿ãã®ãæã£åãæ©ãã§ãããã
//footnote[docker-for-windows][@<href>{https://www.docker.com/docker-windows}]
//footnote[docker-for-mac][@<href>{https://www.docker.com/docker-mac}]
=== Dockerã§åãã
//cmd{
$ docker run --rm -v `pwd`:/work vvakame/review /bin/sh -c "cd /work/articles ;
review-pdfmaker config.yml"
//}
@<tt>{/work/articles} ãšããæå®ã¯ãã®æ¬ã§ã®ãã£ã¬ã¯ããªæ§æã®ç©ã§ãã
ãã£ãããã ãã§ãããªããšç°¡åãªããšã§ããããã
=== Macã§ç°å¢ãæ§ç¯ãã
åºæ¬çã«ã¯Homebrew@<fn>{Homebrew}ãšbrewcaskã掻çšãããšããã§ãããã
//footnote[Homebrew][@<href>{https://brew.sh/index_ja.html}]
//footnote[brewcask][@<href>{https://caskroom.github.io/}]
//cmd{
$ brew cask install mactex
//}
ããšã¯Rubyã¯å¥œããªæ¹æ³ã§ã€ã³ã¹ããŒã«ããŠãããšããã§ããããã·ã¹ãã ã«ãã§ã«å
¥ã£ãŠãããã®ã䜿ããHomebrewã§ã€ã³ã¹ããŒã«ãããrbenvã䜿ããanyenv+rbenvã䜿ããªã©ã®æ段ããããŸãã
//footnote[rbenv][@<href>{https://github.com/rbenv/rbenv}]
//footnote[anyenv+rbenv][@<href>{https://github.com/riywo/anyenv}]
=== Windows ã§ç°å¢ãæ§ç¯ãã
TeXã®ã€ã³ã¹ããŒã«ã«ã¯ãTeXLive@<fn>{TeXLive}ã䜿ãã®ãæè¿ã®éæ¿ã®ããã§ãã
//footnote[TeXLive][@<href>{https://user.ecc.u-tokyo.ac.jp/users/user-15826/wiki/?TeX/Install}]
Rubyã®ã€ã³ã¹ããŒã«ã«ã¯ãRubyInstaller@<fn>{ruby-installer2}ã䜿ããšããããã§ãã
//footnote[ruby-installer2][@<href>{https://github.com/oneclick/rubyinstaller2/releases}]
====[column] æè¡æžã¯Wordã§ãæžãã
æ¬æžã¯Re:VIEW+GitHubã§äžŠè¡å·çãšããç°å¢ãæ§ç¯ããŠãããç°å¢æ§ç¯æé ããèšäºã«ãªã£ãŠãããããããããã¹ã解ãšããããããŠãããšæããããããããŸããã確ãã«ãå·®å管çãåçš¿åºåãªã©ã«ãããŠçŽ æŽãããé¢ãå€ã
ãããæ¯éãªã¹ã¹ã¡ãããç°å¢ã§ã¯ããã®ã§ãããäžæ¹ã§ã€ãããç°å¢èšå®ãããããšã«ããŒãã«ãæããããšããããããããŸããã
çµè«ããèšã£ãŠããŸãã°ãWordã§ãæ®éã«æ¬ã¯æžããã®ã§ãç°å¢æ§ç¯ã§æ«æãããã«ãªãããããªãã(Dockerã䜿ã£ãããšã®ãªãæ¹ãç¹ã«WindowsãŠãŒã¶ãŒã¯)ãšã£ãšãšWordçã®ã¯ãŒãããœããã§æžããŠããŸããŸããããWordã¯Wordã§çããããœããã§ãããæ¥åçšPCããããã¯å®¶åºçšPCã«ãã»ãŒæšæºçã«ã€ã³ã¹ããŒã«ãããŠããããšããããWindowsãŠãŒã¶ãŒã§ãWordãäžåºŠã䜿ã£ãããšããªããšãã人ã¯ããªããŸãããšæããŸãããšããããšã¯ããšã£ãããã®æäœæ¹æ³ã«æ©ãå¿
èŠããªããœããã ãšãããŸãããŸããæ¯èŒçç·šéäžã®èŠãç®ãšå°å·çµæãè¿ãã®ã§ãçŽæçãªå·ç/çµçã«åããŸããRe:VIEWãMarkdownãTeXãªã©ã¯ãæ¬æãšå¶åŸ¡ã³ãŒãã®çŸ
åã§ããããåºæ¥äžãããæ³åããããšã¯ãªããªã倧å€ã§ãããŸãInDesignãªã©ã¯ãäœæ³ãããªãå³ããã£ãããæäœãèŠããŠãŸãšãã«æžããããã«ãªããŸã§ãçµæ§ãããžãã§ãã
æžãå§ããããã®ããŒãã«ã¯ã§ããã ãäžããŠããšã«ããæåã®æ¬ãæžãäžããããšãåªå
ãã¹ãã§ãããã®äžã§ãWordãã¯ãœã ïŒããšããã£ããã次ã®æ¬ã§ä»ã®ç°å¢ãè©Šãã°ããã®ã§ãããããªã䜿ã£ãããšãªãããŒã«ã䜿ãå§ããŠããã®ããŒã«ã®äœ¿ãæ¹ç¿åŸã«å¿æ®ºãããæ¬ãå®æããªããšããã®ã¯æ¬æ«è»¢åã§ããå·çããŒã«ã¯ãããŸã§å·çããŒã«ã§ããïŒText:ããããïŒ
====[/column]