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.

717 line
29KB

  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.05.blog.html">EN</a>
  89. <a href="../ru/education.05.blog.html">RU</a>
  90. </div>
  91. </div>
  92. <center><h1>
  93. Обучение: 05. Блог
  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.04.lang.html">04. Язык</a></td>
  107. <td><a href="education.html">Обучение</a></td>
  108. <td>Отсутствует</td>
  109. </tr>
  110. </tbody>
  111. </table>
  112. <p></div><div class="contents"></p>
  113. <p>В этом документе мы создадим "динамические" страницы блога.</p>
  114. <p>Ожидаемое время завершения: 20 минут.</p>
  115. <p><strong>Содержание</strong></p>
  116. <ul>
  117. <li><a href="#blog">01. Блог</a></li>
  118. <li><a href="#cfg">02. Изучите файл <code>pskov.cfg</code></a></li>
  119. <li><a href="#item">03. Изучите шаблоны элементов</a></li>
  120. <li><a href="#preview">04. Изучите шаблоны предпросмотров</a></li>
  121. <li><a href="#index">05. Изучите шаблоны страниц с предпросмотрами</a></li>
  122. <li><a href="#pagination">06. Изучите постраничные шаблоны</a></li>
  123. <li><a href="#md">07. Изучите файлы Markdown</a></li>
  124. <li><a href="#gen">08. Запустите ЛФСД и сгенерируйте сайт</a></li>
  125. <li><a href="#summary">09. Итог</a></li>
  126. </ul>
  127. <p><a name="blog"/></p>
  128. <h2 id="01">01. Блог</h2>
  129. <p>Итак, у вас есть веб-сайт на Английском и Русском языках. Вы начинаете ощущать желание регулярно делиться своими мыслями с миром в виде заметок блога.</p>
  130. <p>Вы создаёте директорию со <a href="https://github.com/OGStudio/site-pskov-sample/tree/master/03.Blog">следующей структурой файлов</a>:</p>
  131. <ul>
  132. <li><code>pskov.cfg</code></li>
  133. <li><code>en/blog/</code><ul>
  134. <li><code>item.template</code></li>
  135. <li><code>index.template</code></li>
  136. <li><code>preview.template</code></li>
  137. <li><code>pagination.template</code></li>
  138. <li><code>pagination.prev.template</code></li>
  139. <li><code>pagination.next.template</code></li>
  140. <li><code>1885.md</code></li>
  141. <li><code>1886.01.md</code></li>
  142. <li><code>1886.02.md</code></li>
  143. <li><code>1887.01.md</code></li>
  144. <li><code>1887.02.md</code></li>
  145. <li><code>1888.md</code></li>
  146. <li><code>1896.md</code></li>
  147. <li><code>1899.md</code></li></ul></li>
  148. <li><code>en/page/</code><ul>
  149. <li><code>item.template</code></li>
  150. <li><code>about.md</code></li>
  151. <li><code>cv.md</code></li></ul></li>
  152. <li><code>ru/blog/</code><ul>
  153. <li><code>item.template</code></li>
  154. <li><code>index.template</code></li>
  155. <li><code>preview.template</code></li>
  156. <li><code>pagination.template</code></li>
  157. <li><code>pagination.prev.template</code></li>
  158. <li><code>pagination.next.template</code></li>
  159. <li><code>1885.md</code></li>
  160. <li><code>1886.01.md</code></li>
  161. <li><code>1886.02.md</code></li>
  162. <li><code>1887.01.md</code></li>
  163. <li><code>1887.02.md</code></li>
  164. <li><code>1888.md</code></li>
  165. <li><code>1896.md</code></li>
  166. <li><code>1899.md</code></li></ul></li>
  167. <li><code>ru/page/</code><ul>
  168. <li><code>item.template</code></li>
  169. <li><code>about.md</code></li>
  170. <li><code>cv.md</code></li></ul></li>
  171. </ul>
  172. <p>Давайте взглянем на содержимое этих файлов.</p>
  173. <p><a name="cfg"/></p>
  174. <h2 id="02pskovcfg">02. Изучите файл <code>pskov.cfg</code></h2>
  175. <p>Файл <code>pskov.cfg</code> содержит следующее:</p>
  176. <pre><code>input = en/page;ru/page;en/blog;ru/blog
  177. item = item.template
  178. preview = preview.template
  179. index = index.template
  180. paginationPrev = pagination.prev.template
  181. paginationNext = pagination.next.template
  182. paginationPrevNext = pagination.template
  183. previewSize = 200
  184. previewEnding = . . .
  185. previewsPerPage = 3
  186. previewPageBaseName = index
  187. </code></pre>
  188. <p>Вы уже встречались с ключами <code>input</code> и <code>item</code>. Рассмотрим остальные:</p>
  189. <table>
  190. <thead>
  191. <tr>
  192. <th>Ключ</th>
  193. <th>Описание</th>
  194. </tr>
  195. </thead>
  196. <tbody>
  197. <tr>
  198. <td><code>preview</code></td>
  199. <td>Указывает на шаблон HTML, используемый для генерации предпросмотра HTML из первых <code>previewSize</code> (приблизительно) символов для каждого файла Markdown</td>
  200. </tr>
  201. <tr>
  202. <td><code>index</code></td>
  203. <td>Указывает на шаблон HTML, используемый для генерации страницы с предпросмотрами</td>
  204. </tr>
  205. <tr>
  206. <td><code>paginationPrev</code></td>
  207. <td>Указывает на шаблон HTML, используемый для генерации секции с переходом лишь на предыдущую страницу</td>
  208. </tr>
  209. <tr>
  210. <td><code>paginationNext</code></td>
  211. <td>Указывает на шаблон HTML, используемый для генерации секции с переходм лишь на следующую страницу</td>
  212. </tr>
  213. <tr>
  214. <td><code>paginationPrevNext</code></td>
  215. <td>Указывает на шаблон HTML, используемый для генерации секции с переходами по страницам</td>
  216. </tr>
  217. <tr>
  218. <td><code>previewSize</code></td>
  219. <td>Количество символов (приблизительное) из файла Markdown, используемое для генерации предпросмотра</td>
  220. </tr>
  221. <tr>
  222. <td><code>previewEnding</code></td>
  223. <td>Строка для добавления в конец каждого предпросмотра</td>
  224. </tr>
  225. <tr>
  226. <td><code>previewsPerPage</code></td>
  227. <td>Максимальное количество предпросмотров, умещающееся на странице с предпросмотрами</td>
  228. </tr>
  229. <tr>
  230. <td><code>previewsPageBaseName</code></td>
  231. <td>Базовое имя файла для страниц с предпросмотрами</td>
  232. </tr>
  233. </tbody>
  234. </table>
  235. <p>В нашем случае:</p>
  236. <ul>
  237. <li>мы ограничиваем предпросмотр <code>200</code> символами (приблизительно)</li>
  238. <li>мы используем строку <code>. . .</code> в конце каждого предпросмотра</li>
  239. <li>страницы с предпросмотрами вмещают максимум <code>3</code> предпросмотра</li>
  240. <li>страницы с предпросмотрами будут сохранены как <code>index.html</code>, <code>index2.html</code>, <code>index3.html</code> и т.д.</li>
  241. </ul>
  242. <p><a name="item"/></p>
  243. <h2 id="03">03. Изучите шаблоны элементов</h2>
  244. <ul>
  245. <li><p>Содержимое <code>en/blog/item.template</code>:</p>
  246. <pre><code>- - - - Схлопнуто для краткости - - - -
  247. &lt;body&gt;
  248. &lt;div id="header"&gt;
  249. &lt;strong&gt;Serov&lt;/strong&gt;
  250. &lt;a href="../../en/blog/index.html"&gt;Blog&lt;/a&gt;
  251. &lt;a href="../../en/page/about.html"&gt;About me&lt;/a&gt;
  252. &lt;a href="../../en/page/cv.html"&gt;CV&lt;/a&gt;
  253. &lt;div id="lang"&gt;
  254. &lt;a href="../../en/blog/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;
  255. &lt;a href="../../ru/blog/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;
  256. &lt;/div&gt;
  257. &lt;/div&gt;
  258. &lt;center&gt;
  259. &lt;h1&gt;In the blog...&lt;/h1&gt;
  260. &lt;div class="contents"&gt;
  261. &lt;h2 class="itemTitle"&gt;
  262. &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;
  263. &lt;/h2&gt;
  264. &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;
  265. PSKOV_ITEM_CONTENTS
  266. &lt;/div&gt;
  267. &lt;div id="footer"&gt;
  268. This sample web site has been generated by &lt;a href="http://opengamestudio.org/pskov"&gt;PSKOV&lt;/a&gt;.
  269. &lt;/div&gt;
  270. &lt;/center&gt;
  271. &lt;/body&gt;
  272. - - - - Схлопнуто для краткости - - - -
  273. </code></pre></li>
  274. <li><p>Содержимое <code>ru/blog/item.template</code>:</p>
  275. <pre><code>- - - - Схлопнуто для краткости - - - -
  276. &lt;body&gt;
  277. &lt;div id="header"&gt;
  278. &lt;strong&gt;Серов&lt;/strong&gt;
  279. &lt;a href="../../ru/blog/index.html"&gt;Блог&lt;/a&gt;
  280. &lt;a href="../../ru/page/about.html"&gt;Обо мне&lt;/a&gt;
  281. &lt;a href="../../ru/page/cv.html"&gt;Резюме&lt;/a&gt;
  282. &lt;div id="lang"&gt;
  283. &lt;a href="../../en/blog/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;
  284. &lt;a href="../../ru/blog/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;
  285. &lt;/div&gt;
  286. &lt;/div&gt;
  287. &lt;center&gt;
  288. &lt;h1&gt;В блоге...&lt;/h1&gt;
  289. &lt;div class="contents"&gt;
  290. &lt;h2 class="itemTitle"&gt;
  291. &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;
  292. &lt;/h2&gt;
  293. &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;
  294. PSKOV_ITEM_CONTENTS
  295. &lt;/div&gt;
  296. &lt;div id="footer"&gt;
  297. Этот пример сайта сгенерирован &lt;a href="http://opengamestudio.org/pskov"&gt;ПСКОВОМ&lt;/a&gt;.
  298. &lt;/div&gt;
  299. &lt;/center&gt;
  300. &lt;/body&gt;
  301. - - - - Схлопнуто для краткости - - - -
  302. </code></pre></li>
  303. </ul>
  304. <p><strong>Внимание</strong>: начало и конец схлопнуты для краткости.</p>
  305. <p>Как видите, оба файла выглядят практически так же, как и файлы <code>item.template</code>, рассмотренные <a href="education.04.lang.html">ранее</a>.</p>
  306. <p>Изменения следующие:</p>
  307. <ul>
  308. <li>новые URL страниц в директории <code>page</code> и первой страницы с предпросмотрами в директории <code>blog</code></li>
  309. <li>заголовок используется внутри секции <code>contents</code> в качестве ссылки на полную заметку блога</li>
  310. <li>дата используется для подчёркивания временной зависимости между заметками блога</li>
  311. </ul>
  312. <p>Дату мы получаем из константы <code>PSKOV_ITEM_DATE</code>:</p>
  313. <table>
  314. <thead>
  315. <tr>
  316. <th>Константа ПСКОВА</th>
  317. <th>Описание</th>
  318. </tr>
  319. </thead>
  320. <tbody>
  321. <tr>
  322. <td><code>PSKOV_ITEM_DATE</code></td>
  323. <td>Значение ключа <code>Date</code> файла Markdown</td>
  324. </tr>
  325. </tbody>
  326. </table>
  327. <p><a name="preview"/></p>
  328. <h2 id="04">04. Изучите шаблоны предпросмотров</h2>
  329. <ul>
  330. <li><p>Содержимое <code>en/blog/preview.template</code>:</p>
  331. <pre><code>&lt;div class="contents"&gt;
  332. &lt;h2 class="itemTitle"&gt;
  333. &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;
  334. &lt;/h2&gt;
  335. &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;
  336. PSKOV_PREVIEW
  337. &lt;div class="itemMore"&gt;
  338. &lt;a href="PSKOV_ITEM_URL"&gt;Continue reading&lt;/a&gt;
  339. &lt;/div&gt;
  340. &lt;/div&gt;
  341. </code></pre></li>
  342. <li><p>Содержимое <code>ru/blog/preview.template</code>:</p>
  343. <pre><code>&lt;div class="contents"&gt;
  344. &lt;h2 class="itemTitle"&gt;
  345. &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;
  346. &lt;/h2&gt;
  347. &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;
  348. PSKOV_PREVIEW
  349. &lt;div class="itemMore"&gt;
  350. &lt;a href="PSKOV_ITEM_URL"&gt;Читать дальше&lt;/a&gt;
  351. &lt;/div&gt;
  352. &lt;/div&gt;
  353. </code></pre></li>
  354. </ul>
  355. <p>У предпросмотров нет <code>&lt;head&gt;</code>, <code>&lt;body&gt;</code> и прочих полностраничных тэгов HTML. Предпросмотры являются секциями, вставляемыми в страницы с предпросмотрами.</p>
  356. <p>Сам предпросмотр мы получаем из константы <code>PSKOV_PREVIEW</code>:</p>
  357. <table>
  358. <thead>
  359. <tr>
  360. <th>Константа ПСКОВА</th>
  361. <th>Описание</th>
  362. </tr>
  363. </thead>
  364. <tbody>
  365. <tr>
  366. <td><code>PSKOV_PREVIEW</code></td>
  367. <td>Предоставляет содержимое файла Markdown, ограниченное <code>previewSize</code> символами (приблизительно)</td>
  368. </tr>
  369. </tbody>
  370. </table>
  371. <p><a name="index"/></p>
  372. <h2 id="05">05. Изучите шаблоны страниц с предпросмотрами</h2>
  373. <ul>
  374. <li><p>Содержимое <code>en/blog/index.template</code>:</p>
  375. <pre><code>- - - - Схлопнуто для краткости - - - -
  376. &lt;body&gt;
  377. &lt;div id="header"&gt;
  378. &lt;strong&gt;Serov&lt;/strong&gt;
  379. &lt;a href="../../en/blog/index.html"&gt;Blog&lt;/a&gt;
  380. &lt;a href="../../en/page/about.html"&gt;About me&lt;/a&gt;
  381. &lt;a href="../../en/page/cv.html"&gt;CV&lt;/a&gt;
  382. &lt;div id="lang"&gt;
  383. &lt;a href="../../en/blog/PSKOV_INDEX_URL"&gt;EN&lt;/a&gt;
  384. &lt;a href="../../ru/blog/PSKOV_INDEX_URL"&gt;RU&lt;/a&gt;
  385. &lt;/div&gt;
  386. &lt;/div&gt;
  387. &lt;center&gt;
  388. &lt;h1&gt;Blog&lt;/h1&gt;
  389. PSKOV_PREVIEWS
  390. PSKOV_PAGINATION
  391. &lt;div id="footer"&gt;
  392. This sample web site has been generated by &lt;a href="http://opengamestudio.org/pskov"&gt;PSKOV&lt;/a&gt;.
  393. &lt;/div&gt;
  394. &lt;/center&gt;
  395. &lt;/body&gt;
  396. - - - - Схлопнуто для краткости - - - -
  397. </code></pre></li>
  398. <li><p>Содержимое <code>ru/blog/index.template</code>:</p>
  399. <pre><code>- - - - Схлопнуто для краткости - - - -
  400. &lt;body&gt;
  401. &lt;div id="header"&gt;
  402. &lt;strong&gt;Серов&lt;/strong&gt;
  403. &lt;a href="../../ru/blog/index.html"&gt;Блог&lt;/a&gt;
  404. &lt;a href="../../ru/page/about.html"&gt;Обо мне&lt;/a&gt;
  405. &lt;a href="../../ru/page/cv.html"&gt;Резюме&lt;/a&gt;
  406. &lt;div id="lang"&gt;
  407. &lt;a href="../../en/blog/PSKOV_INDEX_URL"&gt;EN&lt;/a&gt;
  408. &lt;a href="../../ru/blog/PSKOV_INDEX_URL"&gt;RU&lt;/a&gt;
  409. &lt;/div&gt;
  410. &lt;/div&gt;
  411. &lt;center&gt;
  412. &lt;h1&gt;Блог&lt;/h1&gt;
  413. PSKOV_PREVIEWS
  414. PSKOV_PAGINATION
  415. &lt;div id="footer"&gt;
  416. Этот пример сайта сгенерирован &lt;a href="http://opengamestudio.org/pskov"&gt;ПСКОВОМ&lt;/a&gt;.
  417. &lt;/div&gt;
  418. &lt;/center&gt;
  419. &lt;/body&gt;
  420. - - - - Схлопнуто для краткости - - - -
  421. </code></pre></li>
  422. </ul>
  423. <p><strong>Замечания</strong>:</p>
  424. <ul>
  425. <li>начало и конец схлопнуты для краткости</li>
  426. <li>константа <code>PSKOV_INDEX_URL</code> используется для выбора языка</li>
  427. </ul>
  428. <p>Новые константы <strong>ПСКОВА</strong>:</p>
  429. <table>
  430. <thead>
  431. <tr>
  432. <th>Константа ПСКОВА</th>
  433. <th>Описание</th>
  434. </tr>
  435. </thead>
  436. <tbody>
  437. <tr>
  438. <td><code>PSKOV_INDEX_URL</code></td>
  439. <td>Предоставляет генерируемое имя файла страницы с предпросмотрами: <code>&lt;previewsPageBaseName&gt;&lt;id&gt;.html</code></td>
  440. </tr>
  441. <tr>
  442. <td><code>PSKOV_PREVIEWS</code></td>
  443. <td>Предоставляет набор предпросмотров</td>
  444. </tr>
  445. <tr>
  446. <td><code>PSKOV_PAGINATION</code></td>
  447. <td>Предоставляет секцию для перехода между страницами с предпросмотрами</td>
  448. </tr>
  449. </tbody>
  450. </table>
  451. <p><a name="pagination"/></p>
  452. <h2 id="06">06. Изучите постраничные шаблоны</h2>
  453. <p>Постраничные шаблоны являются секциями HTML для перехода между страницами с предпросмотрами.</p>
  454. <p>Существует три постраничных шаблона:</p>
  455. <table>
  456. <thead>
  457. <tr>
  458. <th>Постраничный шаблон</th>
  459. <th>Описание</th>
  460. </tr>
  461. </thead>
  462. <tbody>
  463. <tr>
  464. <td>Предыдущий</td>
  465. <td>Посетитель может перейти лишь назад</td>
  466. </tr>
  467. <tr>
  468. <td>Следующий</td>
  469. <td>Посетитель может перейти лишь вперёд</td>
  470. </tr>
  471. <tr>
  472. <td>Оба</td>
  473. <td>Посетитель может перейти либо вперёд, либо назад</td>
  474. </tr>
  475. </tbody>
  476. </table>
  477. <p>Рассмотрим английские постраничные шаблоны:</p>
  478. <ul>
  479. <li><p>Содержимое <code>en/blog/pagination.prev.template</code>:</p>
  480. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;
  481. &lt;p&gt;
  482. &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Newer&lt;/a&gt;
  483. &lt;/p&gt;
  484. </code></pre></li>
  485. <li><p>Содержимое <code>en/blog/pagination.next.template</code>:</p>
  486. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;
  487. &lt;p&gt;
  488. &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Older »&lt;/a&gt;
  489. &lt;/p&gt;
  490. </code></pre></li>
  491. <li><p>Содержимое <code>en/blog/pagination.template</code>:</p>
  492. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;
  493. &lt;p&gt;
  494. &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Newer&lt;/a&gt;
  495. &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Older »&lt;/a&gt;
  496. &lt;/p&gt;
  497. </code></pre></li>
  498. </ul>
  499. <p>Русские версии выглядят схожим образом. Например, содержимое <code>ru/blog/pagination.template</code>:</p>
  500. <pre><code>&lt;p&gt;Страница PSKOV_PAGE_ID из PSKOV_PAGES_COUNT&lt;/p&gt;
  501. &lt;p&gt;
  502. &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Новее&lt;/a&gt;
  503. &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Старее »&lt;/a&gt;
  504. &lt;/p&gt;
  505. </code></pre>
  506. <p>Новые константы <strong>ПСКОВА</strong>:</p>
  507. <table>
  508. <thead>
  509. <tr>
  510. <th>Константа ПСКОВА</th>
  511. <th>Описание</th>
  512. </tr>
  513. </thead>
  514. <tbody>
  515. <tr>
  516. <td><code>PSKOV_PAGE_ID</code></td>
  517. <td>Предоставляет порядковый номер страницы с предпросмотрами, начиная с <code>1</code></td>
  518. </tr>
  519. <tr>
  520. <td><code>PSKOV_PAGES_COUNT</code></td>
  521. <td>Предоставляет количество сгенерированных страниц с предпросмотрами</td>
  522. </tr>
  523. <tr>
  524. <td><code>PSKOV_PREV_PAGE_URL</code></td>
  525. <td>Предоставляет имя файла предыдущей страницы с предпросмотрами</td>
  526. </tr>
  527. <tr>
  528. <td><code>PSKOV_NEXT_PAGE_URL</code></td>
  529. <td>Предоставляет имя файла следующей страницы с предпросмотрами</td>
  530. </tr>
  531. </tbody>
  532. </table>
  533. <p><a name="md"/></p>
  534. <h2 id="07markdown">07. Изучите файлы Markdown</h2>
  535. <p>Файлы Markdown являются заметками блога, они похожи на файлы Markdown обычных страниц. Вот как выглядит содержимое <code>en/blog/1885.md</code>:</p>
  536. <pre><code> Title: Bullocks
  537. Date: 1885
  538. Slug: 1885.01.bullocks
  539. ![Bullocks][bullocks]
  540. I've been painting "Bullocks" sketch while I was staying in Odessa at Kuznetsov's in 1885.
  541. [bullocks]: https://upload.wikimedia.org/wikipedia/commons/c/cb/Walentin_Aleksandrovich_Serov_Bullocks.jpg
  542. </code></pre>
  543. <p>Заметки блога сортируются по дате: новые заметки размещаются перед старыми.</p>
  544. <table>
  545. <thead>
  546. <tr>
  547. <th>Ключ заголовка</th>
  548. <th>Описание</th>
  549. </tr>
  550. </thead>
  551. <tbody>
  552. <tr>
  553. <td><code>Date</code></td>
  554. <td>Предоставляет значение для константы <code>PSKOV_ITEM_DATE</code> при генерации HTML из Markdown</td>
  555. </tr>
  556. </tbody>
  557. </table>
  558. <p><a name="gen"/></p>
  559. <h2 id="08">08. Запустите ЛФСД и сгенерируйте сайт</h2>
  560. <p>Запустите <a href="http://opengamestudio.org/lfsa/ru">ЛФСД</a> с указанием директории, содержащей только что рассмотренные файлы:</p>
  561. <pre><code>$ /путь/до/lfsa_1.0.0.py /путь/до/директории/03.Blog
  562. </code></pre>
  563. <p>Сгенерируйте сайт:</p>
  564. <ul>
  565. <li>Перейдите на страницу <a href="http://opengamestudio.org/pskov/ru/pskov_1.0.0+ru.html">Инструмент</a></li>
  566. <li>Нажмите кнопку <code>Генерировать</code></li>
  567. <li>Откройте сгенерированный файл <code>en/blog/index.html</code> или <code>ru/blog/index.html</code> из директории сайта</li>
  568. <li>Осуществите переход между страницами предпросмотра</li>
  569. </ul>
  570. <p><a name="summary"/></p>
  571. <h2 id="09">09. Итог</h2>
  572. <p>Вы успешно сгенерировали веб-сайт с "динамическими" страницами блога. <a href="http://opengamestudio.org/pskov/sample/03.Blog/ru/blog/index.html">Проверьте результат</a>.</p>
  573. <p>Представлены константы <strong>ПСКОВА</strong>:</p>
  574. <table>
  575. <thead>
  576. <tr>
  577. <th>Константа ПСКОВА</th>
  578. <th>Описание</th>
  579. </tr>
  580. </thead>
  581. <tbody>
  582. <tr>
  583. <td><code>PSKOV_ITEM_DATE</code></td>
  584. <td>Значение ключа <code>Date</code> файла Markdown</td>
  585. </tr>
  586. <tr>
  587. <td><code>PSKOV_PREVIEW</code></td>
  588. <td>Предоставляет содержимое файла Markdown, ограниченное <code>previewSize</code> символами (приблизительно)</td>
  589. </tr>
  590. <tr>
  591. <td><code>PSKOV_INDEX_URL</code></td>
  592. <td>Предоставляет генерируемое имя файла страницы с предпросмотрами: <code>&lt;previewsPageBaseName&gt;&lt;id&gt;.html</code></td>
  593. </tr>
  594. <tr>
  595. <td><code>PSKOV_PREVIEWS</code></td>
  596. <td>Предоставляет набор предпросмотров</td>
  597. </tr>
  598. <tr>
  599. <td><code>PSKOV_PAGINATION</code></td>
  600. <td>Предоставляет секцию для перехода между страницами с предпросмотрами</td>
  601. </tr>
  602. <tr>
  603. <td><code>PSKOV_PAGE_ID</code></td>
  604. <td>Предоставляет порядковый номер страницы с предпросмотрами, начиная с <code>1</code></td>
  605. </tr>
  606. <tr>
  607. <td><code>PSKOV_PAGES_COUNT</code></td>
  608. <td>Предоставляет количество сгенерированных страниц с предпросмотрами</td>
  609. </tr>
  610. <tr>
  611. <td><code>PSKOV_PREV_PAGE_URL</code></td>
  612. <td>Предоставляет имя файла предыдущей страницы с предпросмотрами</td>
  613. </tr>
  614. <tr>
  615. <td><code>PSKOV_NEXT_PAGE_URL</code></td>
  616. <td>Предоставляет имя файла следующей страницы с предпросмотрами</td>
  617. </tr>
  618. </tbody>
  619. </table>
  620. <p>Представлены ключи настроек:</p>
  621. <table>
  622. <thead>
  623. <tr>
  624. <th>Ключ</th>
  625. <th>Описание</th>
  626. </tr>
  627. </thead>
  628. <tbody>
  629. <tr>
  630. <td><code>preview</code></td>
  631. <td>Указывает на шаблон HTML, используемый для генерации предпросмотра HTML из первых <code>previewSize</code> (приблизительно) символов для каждого файла Markdown</td>
  632. </tr>
  633. <tr>
  634. <td><code>index</code></td>
  635. <td>Указывает на шаблон HTML, используемый для генерации страницы с предпросмотрами</td>
  636. </tr>
  637. <tr>
  638. <td><code>paginationPrev</code></td>
  639. <td>Указывает на шаблон HTML, используемый для генерации секции с переходом лишь на предыдущую страницу</td>
  640. </tr>
  641. <tr>
  642. <td><code>paginationNext</code></td>
  643. <td>Указывает на шаблон HTML, используемый для генерации секции с переходм лишь на следующую страницу</td>
  644. </tr>
  645. <tr>
  646. <td><code>paginationPrevNext</code></td>
  647. <td>Указывает на шаблон HTML, используемый для генерации секции с переходами по страницам</td>
  648. </tr>
  649. <tr>
  650. <td><code>previewSize</code></td>
  651. <td>Количество символов (приблизительное) из файла Markdown, используемое для генерации предпросмотра</td>
  652. </tr>
  653. <tr>
  654. <td><code>previewEnding</code></td>
  655. <td>Строка для добавления в конец каждого предпросмотра</td>
  656. </tr>
  657. <tr>
  658. <td><code>previewsPerPage</code></td>
  659. <td>Максимальное количество предпросмотров, умещающееся на странице с предпросмотрами</td>
  660. </tr>
  661. <tr>
  662. <td><code>previewsPageBaseName</code></td>
  663. <td>Базовое имя файла для страниц с предпросмотрами</td>
  664. </tr>
  665. </tbody>
  666. </table>
  667. <p>Представлены ключи заголовка:</p>
  668. <table>
  669. <thead>
  670. <tr>
  671. <th>Ключ заголовка</th>
  672. <th>Описание</th>
  673. </tr>
  674. </thead>
  675. <tbody>
  676. <tr>
  677. <td><code>Date</code></td>
  678. <td>Предоставляет значение для константы <code>PSKOV_ITEM_DATE</code> при генерации HTML из Markdown</td>
  679. </tr>
  680. </tbody>
  681. </table>
  682. <p>Это был последний документ, призванный научить вас уверенно владеть генератором статических сайтов <strong>ПСКОВ</strong>. Если вам нравится наш труд, присоединяйтесь к нам в <a href="https://vk.com/opengamestudo">VK</a>, <a href="https://twitter.com/OpenGameStudio">Twitter</a> или <a href="https://www.facebook.com/groups/162611230470183">Facebook</a>.</p>
  683. <p>А теперь используйте <strong>ПСКОВ</strong> для генерация своего собственного веб-сайта!</p>
  684. <p></div><div class="contents"></p>
  685. <table>
  686. <thead>
  687. <tr>
  688. <th>&lt; Назад</th>
  689. <th>Начало</th>
  690. <th>Далее &gt;</th>
  691. </tr>
  692. </thead>
  693. <tbody>
  694. <tr>
  695. <td><a href="education.04.lang.html">04. Язык</a></td>
  696. <td><a href="education.html">Обучение</a></td>
  697. <td>Отсутствует</td>
  698. </tr>
  699. </tbody>
  700. </table>
  701. </div></center>
  702. <div id="footer">
  703. Сайт сгенерирован <a href="http://opengamestudio.org/pskov">ПСКОВОМ</a>
  704. из <a href="http://github.com/ogstudio/site-pskov">этого исходного кода</a>.
  705. Сайт расположен на <a href="https://pages.github.com">GitHub Pages</a>.
  706. </div>
  707. <script type="text/javascript">
  708. </script>
  709. </body>
  710. </html>