You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

402 line
15KB

  1. <!DOCTYPE html>
  2. <html>
  3. <meta charset="utf-8">
  4. <head>
  5. <style>
  6. #header
  7. {
  8. background: #856d51;
  9. padding: 0.7em;
  10. text-align: left;
  11. }
  12. #header a
  13. {
  14. color: white;
  15. text-decoration: none;
  16. padding: 0.5em 1em 0.5em 1em;
  17. }
  18. #title
  19. {
  20. color: #433729;
  21. }
  22. html
  23. {
  24. font-family: sans-serif;
  25. }
  26. body
  27. {
  28. line-height: 1.5em;
  29. }
  30. body
  31. {
  32. background: #FAFAFA;
  33. }
  34. table
  35. {
  36. border-collapse: collapse;
  37. width: 100%;
  38. }
  39. table, th, td
  40. {
  41. border: 1px solid #aaa;
  42. padding: 0.5em;
  43. margin-top: 0.5em;
  44. margin-bottom: 0.5em;
  45. }
  46. code, pre
  47. {
  48. font-family: monospace, serif;
  49. font-size: 1em;
  50. color: #7f0a0c;
  51. background: #f5f5f5;
  52. white-space: pre-wrap;
  53. }
  54. video
  55. {
  56. width: 100%;
  57. }
  58. .contents
  59. {
  60. background: #FFFFFF;
  61. width: 720px;
  62. padding: 1em;
  63. margin-top: 2em;
  64. margin-bottom: 2em;
  65. border: 1px solid #E0E0E0;
  66. text-align: left;
  67. color: #444;
  68. }
  69. #footer
  70. {
  71. text-align: center;
  72. }
  73. #lang
  74. {
  75. float: right;
  76. }
  77. </style>
  78. <title>
  79. PSKOV
  80. </title>
  81. </head>
  82. <body>
  83. <div id="header">
  84. <strong id="title">ПСКОВ</strong>
  85. <a href="pskov_1.0.0+ru.html">Инструмент</a>
  86. <a href="education.html">Обучение</a>
  87. <div id="lang">
  88. <a href="../en/education.03.site.html">EN</a>
  89. <a href="../ru/education.03.site.html">RU</a>
  90. </div>
  91. </div>
  92. <center><h1>
  93. Обучение: 03. Сайт
  94. </h1></center>
  95. <center><div class="contents">
  96. <table>
  97. <thead>
  98. <tr>
  99. <th>&lt; Назад</th>
  100. <th>Начало</th>
  101. <th>Далее &gt;</th>
  102. </tr>
  103. </thead>
  104. <tbody>
  105. <tr>
  106. <td><a href="education.02.deps.html">02. Зависимости</a></td>
  107. <td><a href="education.html">Обучение</a></td>
  108. <td><a href="education.04.lang.html">04. Язык</a></td>
  109. </tr>
  110. </tbody>
  111. </table>
  112. <p></div><div class="contents"></p>
  113. <p>В этом документы мы создадим простой статический сайт с двумя страницами.</p>
  114. <p>Ожидаемое время завершения: 10 минут.</p>
  115. <p><strong>Содержание</strong></p>
  116. <ul>
  117. <li><a href="#inspiration">01. Вдохновление</a></li>
  118. <li><a href="#cfg">02. Изучите файл <code>pskov.cfg</code></a></li>
  119. <li><a href="#item">03. Изучите файл <code>item.template</code></a></li>
  120. <li><a href="#md">04. Изучите файлы <code>about.md</code> и <code>cv.md</code></a></li>
  121. <li><a href="#lfsa">05. Запустите ЛФСД</a></li>
  122. <li><a href="#gen">06. Сгенерируйте сайт</a></li>
  123. <li><a href="#observe">07. Проверьте сайт</a></li>
  124. <li><a href="#summary">08. Итог</a></li>
  125. </ul>
  126. <p><a name="inspiration"/></p>
  127. <h2 id="01">01. Вдохновление</h2>
  128. <p>Представьте, что вы являетесь выдающимся русским живописцем Валентином Серовым. Каждый раз, когда кто-либо хочет узнать о вас, он идёт на <a href="https://ru.wikipedia.org/wiki/%D0%A1%D0%B5%D1%80%D0%BE%D0%B2,_%D0%92%D0%B0%D0%BB%D0%B5%D0%BD%D1%82%D0%B8%D0%BD_%D0%90%D0%BB%D0%B5%D0%BA%D1%81%D0%B0%D0%BD%D0%B4%D1%80%D0%BE%D0%B2%D0%B8%D1%87">Википедию</a>. Сегодня утром вы просыпаетесь раньше обычного с отчётливым желанием создать свой собственный веб-сайт.</p>
  129. <p>Вы приступаете к созданию следующих страницы:</p>
  130. <ul>
  131. <li>About me</li>
  132. <li>Curriculum vitae (CV)</li>
  133. </ul>
  134. <p>Несколько позже в <a href="https://github.com/OGStudio/site-pskov-sample/tree/master/01.TwoPages">директории вашего сайта</a> у вас оказываются следующие файлы:</p>
  135. <ul>
  136. <li>pskov.cfg</li>
  137. <li>item.template</li>
  138. <li>about.md</li>
  139. <li>cv.md</li>
  140. </ul>
  141. <p>Давайте взглянем на их содержимое.</p>
  142. <p><a name="cfg"/></p>
  143. <h2 id="02pskovcfg">02. Изучите файл <code>pskov.cfg</code></h2>
  144. <p>Файл <code>pskov.cfg</code> содержит следующее:</p>
  145. <pre><code>input = .
  146. item = item.template
  147. </code></pre>
  148. <p><code>pskov.cfg</code> является <a href="https://ru.wikipedia.org/wiki/.ini">файлом настроек</a> со следующими ключами:</p>
  149. <table>
  150. <thead>
  151. <tr>
  152. <th>Ключ</th>
  153. <th>Описание</th>
  154. </tr>
  155. </thead>
  156. <tbody>
  157. <tr>
  158. <td><code>input</code></td>
  159. <td>Указывает на директорию с файлом, на который ссылается ключ <code>item</code></td>
  160. </tr>
  161. <tr>
  162. <td><code>item</code></td>
  163. <td>Указывает на файл с шаблоном HTML, который используется для генерации файлов HTML из Markdown</td>
  164. </tr>
  165. </tbody>
  166. </table>
  167. <p>В нашем случае файл <code>item.template</code> расположен рядом с <code>pskov.cfg</code>, поэтому мы используем <code>.</code> для обозначения текущей директории.</p>
  168. <p><a name="item"/></p>
  169. <h2 id="03itemtemplate">03. Изучите файл <code>item.template</code></h2>
  170. <p>Файл <code>item.template</code> содержит следующее:</p>
  171. <pre><code>&lt;!DOCTYPE html&gt;
  172. &lt;html&gt;
  173. &lt;meta charset="utf-8"&gt;
  174. &lt;head&gt;
  175. &lt;style&gt;
  176. - - - - Схлопнуто для краткости - - - -
  177. &lt;/style&gt;
  178. &lt;title&gt;Serov&lt;/title&gt;
  179. &lt;/head&gt;
  180. &lt;body&gt;
  181. &lt;div id="header"&gt;
  182. &lt;strong&gt;Serov&lt;/strong&gt;
  183. &lt;a href="about.html"&gt;About me&lt;/a&gt;
  184. &lt;a href="cv.html"&gt;CV&lt;/a&gt;
  185. &lt;/div&gt;
  186. &lt;center&gt;
  187. &lt;h1&gt;PSKOV_ITEM_TITLE&lt;/h1&gt;
  188. &lt;div class="contents"&gt;
  189. PSKOV_ITEM_CONTENTS
  190. &lt;/div&gt;
  191. &lt;div id="footer"&gt;
  192. This sample web site has been generated by &lt;a href="http://opengamestudio.org/pskov"&gt;PSKOV&lt;/a&gt;.
  193. &lt;/div&gt;
  194. &lt;/center&gt;
  195. &lt;/body&gt;
  196. &lt;/html&gt;
  197. </code></pre>
  198. <p><strong>Внимание</strong>: стиль схлопнут для краткости.</p>
  199. <p>Как видите, <code>item.template</code> представляет из себя обычный файл HTML с двумя константами <strong>ПСКОВА</strong>:</p>
  200. <table>
  201. <thead>
  202. <tr>
  203. <th>Константа ПСКОВА</th>
  204. <th>Описание</th>
  205. </tr>
  206. </thead>
  207. <tbody>
  208. <tr>
  209. <td><code>PSKOV_ITEM_TITLE</code></td>
  210. <td>Значение ключа <code>Title</code> из файла Markdown страницы</td>
  211. </tr>
  212. <tr>
  213. <td><code>PSKOV_ITEM_CONTENTS</code></td>
  214. <td>Предоставляет содержимое HTML, сгенерированное из Markdown</td>
  215. </tr>
  216. </tbody>
  217. </table>
  218. <p><strong>Замечания</strong>:</p>
  219. <ul>
  220. <li>другие константы <strong>ПСКОВА</strong> описаны позже</li>
  221. <li>файл Markdown страницы описан ниже</li>
  222. </ul>
  223. <p><a name="md"/></p>
  224. <h2 id="04aboutmdcvmd">04. Изучите файлы <code>about.md</code> и <code>cv.md</code></h2>
  225. <p>Файл <code>about.md</code> содержит следующее:</p>
  226. <pre><code> Title: About me
  227. Slug: about
  228. Hi, my name is Valentin Serov. Here's my self-portrait:
  229. ![Valentin Serov self-portrait][serov-portrait]
  230. - - - - Схлопнуто для краткости - - - -
  231. Have a look at my [CV][cv] now.
  232. [serov]: https://en.wikipedia.org/wiki/Valentin_Serov
  233. [revolution]: https://en.wikipedia.org/wiki/Russian_Revolution
  234. [serov-portrait]: myself.jpg
  235. [serov-work]: mywork.jpg
  236. [girl-with-peaches]: https://en.wikipedia.org/wiki/Girl_with_Peaches
  237. [pskov]: http://opengamestudio.org/pskov
  238. [cv]: cv.html
  239. </code></pre>
  240. <p><code>about.md</code> начинается с так называемого заголовка:</p>
  241. <table>
  242. <thead>
  243. <tr>
  244. <th>Ключ заголовка</th>
  245. <th>Описание</th>
  246. </tr>
  247. </thead>
  248. <tbody>
  249. <tr>
  250. <td><code>Title</code></td>
  251. <td>Предоставляет значение для константы <code>PSKOV_ITEM_TITLE</code> во время генерации HTML из Markdown</td>
  252. </tr>
  253. <tr>
  254. <td><code>Slug</code></td>
  255. <td>Сообщает <strong>ПСКОВУ</strong> о том, что этот файл должен быть сохранён как <code>&lt;slug&gt;.html</code></td>
  256. </tr>
  257. </tbody>
  258. </table>
  259. <p>В остальном содержимое <code>about.md</code> ничем не отличается от любых других файлов Markdown.</p>
  260. <p><strong>Внимание</strong>: ссылка на страницу <code>cv</code> указана как <code>cv.html</code>, не <code>cv.md</code></p>
  261. <p>Файл <code>cv.md</code> содержит следующее:</p>
  262. <pre><code> Title: Curriculum vitae
  263. Slug: cv
  264. Here's my CV in case my paintings still interest you. I took a bit of a modern IT approach to structure my CV as key-value pairs of a dictionary (map), enjoy!
  265. | Key | Value |
  266. |---|---|
  267. | Name | Valentin Serov |
  268. | Age | 46 |
  269. | Marital status | Married |
  270. | Country | Russian Empire |
  271. | Alma mater | Imperial Academy of Arts |
  272. | Education | * Member Academy of Arts (1898) &lt;br&gt; * Full Member Academy of Arts (1903) |
  273. </code></pre>
  274. <p>Как видите, в <code>cv.md</code> нет ничего нового за исключением таблицы Markdown.</p>
  275. <p><a name="lfsa"/></p>
  276. <h2 id="05">05. Запустите ЛФСД</h2>
  277. <video controls poster="../vid/education.03.site.launch-lfsa.w2k.poster.png">
  278. <source src="../vid/education.03.site.launch-lfsa.w2k.mp4" type ="video/mp4">
  279. <source src="../vid/education.03.site.launch-lfsa.w2k.webm" type ="video/webm">
  280. ОШИБКА Ваш браузер не поддерживает видео HTML5
  281. </video>
  282. <p>Запустите <a href="http://opengamestudio.org/lfsa/ru">ЛФСД</a> с указанием директории, содержащей только что рассмотренные файлы:</p>
  283. <pre><code>$ /путь/до/lfsa_1.0.0.py /путь/до/директории/01.TwoPages
  284. </code></pre>
  285. <p>Вы должны увидеть примерно такой вывод:</p>
  286. <pre><code>DIR: '/Users/kornerr/p/site-pskov-sample/01.TwoPages'
  287. PORT: '8000'
  288. </code></pre>
  289. <p><a name="gen"/></p>
  290. <h2 id="06">06. Сгенерируйте сайт</h2>
  291. <video controls poster="../vid/education.03.site.gen.w2k.poster+ru.png">
  292. <source src="../vid/education.03.site.gen.w2k+ru.mp4" type ="video/mp4">
  293. <source src="../vid/education.03.site.gen.w2k+ru.webm" type ="video/webm">
  294. ОШИБКА Ваш браузер не поддерживает видео HTML5
  295. </video>
  296. <p>Перейдите на страницу <a href="http://opengamestudio.org/pskov/ru/pskov_1.0.0+ru.html">Инструмент</a> и нажмите кнопку <code>Генерировать</code> для генерации файлов HTML рядом с файлами Markdown.</p>
  297. <p><a name="observe"/></p>
  298. <h2 id="07">07. Проверьте сайт</h2>
  299. <video controls poster="../vid/education.03.site.observe.w2k.poster.png">
  300. <source src="../vid/education.03.site.observe.w2k.mp4" type ="video/mp4">
  301. <source src="../vid/education.03.site.observe.w2k.webm" type ="video/webm">
  302. ОШИБКА Ваш браузер не поддерживает видео HTML5
  303. </video>
  304. <p>Проверьте сгенерированный веб-сайт локально: откройте файл <code>about.html</code> и совершите переход между страницами.</p>
  305. <p><a name="summary"/></p>
  306. <h2 id="08">08. Итог</h2>
  307. <p>Вы успешно сгенерировали веб-сайт с двумя страницами. <a href="http://opengamestudio.org/pskov/sample/01.TwoPages/about.html">Проверьте результат</a>.</p>
  308. <p>Представлены константы <strong>ПСКОВА</strong>:</p>
  309. <table>
  310. <thead>
  311. <tr>
  312. <th>Константа ПСКОВА</th>
  313. <th>Описание</th>
  314. </tr>
  315. </thead>
  316. <tbody>
  317. <tr>
  318. <td><code>PSKOV_ITEM_TITLE</code></td>
  319. <td>Значение ключа <code>Title</code> из файла Markdown страницы</td>
  320. </tr>
  321. <tr>
  322. <td><code>PSKOV_ITEM_CONTENTS</code></td>
  323. <td>Предоставляет содержимое HTML, сгенерированное из Markdown</td>
  324. </tr>
  325. </tbody>
  326. </table>
  327. <p>Представлены ключи настроек:</p>
  328. <table>
  329. <thead>
  330. <tr>
  331. <th>Ключ</th>
  332. <th>Описание</th>
  333. </tr>
  334. </thead>
  335. <tbody>
  336. <tr>
  337. <td><code>input</code></td>
  338. <td>Указывает на директорию с файлом, на который ссылается ключ <code>item</code></td>
  339. </tr>
  340. <tr>
  341. <td><code>item</code></td>
  342. <td>Указывает на файл с шаблоном HTML, который используется для генерации файлов HTML из Markdown</td>
  343. </tr>
  344. </tbody>
  345. </table>
  346. <p>Представлены ключи заголовка:</p>
  347. <table>
  348. <thead>
  349. <tr>
  350. <th>Ключ заголовка</th>
  351. <th>Описание</th>
  352. </tr>
  353. </thead>
  354. <tbody>
  355. <tr>
  356. <td><code>Title</code></td>
  357. <td>Предоставляет значение для константы <code>PSKOV_ITEM_TITLE</code> во время генерации HTML из Markdown</td>
  358. </tr>
  359. <tr>
  360. <td><code>Slug</code></td>
  361. <td>Сообщает <strong>ПСКОВУ</strong> о том, что этот файл должен быть сохранён как <code>&lt;slug&gt;.html</code></td>
  362. </tr>
  363. </tbody>
  364. </table>
  365. <p></div><div class="contents"></p>
  366. <table>
  367. <thead>
  368. <tr>
  369. <th>&lt; Назад</th>
  370. <th>Начало</th>
  371. <th>Далее &gt;</th>
  372. </tr>
  373. </thead>
  374. <tbody>
  375. <tr>
  376. <td><a href="education.02.deps.html">02. Зависимости</a></td>
  377. <td><a href="education.html">Обучение</a></td>
  378. <td><a href="education.04.lang.html">04. Язык</a></td>
  379. </tr>
  380. </tbody>
  381. </table>
  382. </div></center>
  383. <div id="footer">
  384. Сайт сгенерирован <a href="http://opengamestudio.org/pskov">ПСКОВОМ</a>
  385. из <a href="http://github.com/ogstudio/site-pskov">этого исходного кода</a>.
  386. Сайт расположен на <a href="https://pages.github.com">GitHub Pages</a>.
  387. </div>
  388. <script type="text/javascript">
  389. </script>
  390. </body>
  391. </html>