OGS-Main
/
ogs-site
2
0
Форкнуть 0
Код Задачи 0 Pull Request'ы 0 Релизы 0 Вики Активность
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.
135 коммитов
2 Ветки
123MB
Дерево: 250d142b99
Ветки Теги
${ item.name }
Создать ветку ${ searchTerm }
из '250d142b99'
${ noResults }
ogs-site/pskov/en/education.05.blog.html

733 строки
24KB
Исходник Blame История 

  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.             

  13.             #header a

  14.             {

  15.                 color: white;

  16.                 text-decoration: none;

  17.                 padding: 0.5em 1em 0.5em 1em;

  18.             }

  19.             #title

  20.             {

  21.                 color: #433729;

  22.             }

  23.             html

  24.             {

  25.                 font-family: sans-serif;

  26.             }

  27.             body

  28.             {

  29.                 line-height: 1.5em;

  30.             }

  31.             body

  32.             {

  33.                 background: #FAFAFA;

  34.             }

  35.             table

  36.             {

  37.                 border-collapse: collapse;

  38.                 width: 100%;

  39.             }

  40.             

  41.             table, th, td

  42.             {

  43.                 border: 1px solid #aaa;

  44.                 padding: 0.5em;

  45.                 margin-top: 0.5em;

  46.                 margin-bottom: 0.5em;

  47.             }

  48.             code, pre

  49.             {

  50.                 font-family: monospace, serif;

  51.                 font-size: 1em;

  52.                 color: #7f0a0c;

  53.                 background: #f5f5f5;

  54.                 white-space: pre-wrap;

  55.             }

  56.             video

  57.             {

  58.                 width: 100%;

  59.             }

  60.             .contents

  61.             {

  62.                 background: #FFFFFF;

  63.                 width: 720px;

  64.                 padding: 1em;

  65.                 margin-top: 2em;

  66.                 margin-bottom: 2em;

  67.                 border: 1px solid #E0E0E0;

  68.                 text-align: left;

  69.                 color: #444;

  70.             }

  71.             #footer

  72.             {

  73.                 text-align: center;

  74.             }

  75.             #lang

  76.             {

  77.                 float: right;

  78.             }

  79.         </style>

  80.         <title>

  81.             PSKOV

  82.         </title>

  83.     </head>

  84.     <body>

  85.         <div id="header">

  86.             <strong id="title">PSKOV</strong>

  87.             <a href="pskov_1.0.0.html">Tool</a>

  88.             <a href="education.html">Education</a>

  89.             <div id="lang">

  90.                 <a href="../en/education.05.blog.html">EN</a>

  91.                 <a href="../ru/education.05.blog.html">RU</a>

  92.             </div>

  93.         </div>

  94.         <center><h1>

  95. Education: 05. Blog

  96.         </h1></center>

  97.         <center><div class="contents">

  98. <table>

  99. <thead>

  100. <tr>

  101. <th>&lt; Back</th>

  102. <th>Index</th>

  103. <th>Next &gt;</th>

  104. </tr>

  105. </thead>

  106. <tbody>

  107. <tr>

  108. <td><a href="education.04.lang.html">04. Language</a></td>

  109. <td><a href="education.html">Education</a></td>

  110. <td>Not available</td>

  111. </tr>

  112. </tbody>

  113. </table>

  114. <p></div><div class="contents"></p>

  115. <p>In this document we create "dynamic" pages for a blog.</p>

  116. <p>Estimated completion time: 20 minutes.</p>

  117. <p><strong>Table of contents</strong></p>

  118. <ul>

  119. <li><a href="#blog">01. Blog</a></li>

  120. <li><a href="#cfg">02. Investigate <code>pskov.cfg</code> file</a></li>

  121. <li><a href="#item">03. Investigate item templates of the blog</a></li>

  122. <li><a href="#preview">04. Investigate preview templates</a></li>

  123. <li><a href="#index">05. Investigate templates of preview pages</a></li>

  124. <li><a href="#pagination">06. Investigate pagination templates</a></li>

  125. <li><a href="#md">07. Investigate Markdown files</a></li>

  126. <li><a href="#lfsa">08. Launch LFSA</a></li>

  127. <li><a href="#gen">09. Generate the site</a></li>

  128. <li><a href="#observe">10. Observe the site</a></li>

  129. <li><a href="#summary">11. Summary</a></li>

  130. </ul>

  131. <p><a name="blog"/></p>

  132. <h2 id="01blog">01. Blog</h2>

  133. <p>So, you have your web site in both English and Russian. You start to feel the need to regularly share your thoughts with the world as blog posts.</p>

  134. <p>You set on to create the following <a href="https://github.com/OGStudio/site-pskov-sample/tree/master/03.Blog">directory structure</a>:</p>

  135. <ul>

  136. <li><code>pskov.cfg</code></li>

  137. <li><code>en/blog/</code><ul>

  138. <li><code>item.template</code></li>

  139. <li><code>index.template</code></li>

  140. <li><code>preview.template</code></li>

  141. <li><code>pagination.template</code></li>

  142. <li><code>pagination.prev.template</code></li>

  143. <li><code>pagination.next.template</code></li>

  144. <li><code>1885.md</code></li>

  145. <li><code>1886.01.md</code></li>

  146. <li><code>1886.02.md</code></li>

  147. <li><code>1887.01.md</code></li>

  148. <li><code>1887.02.md</code></li>

  149. <li><code>1888.md</code></li>

  150. <li><code>1896.md</code></li>

  151. <li><code>1899.md</code></li></ul></li>

  152. <li><code>en/page/</code><ul>

  153. <li><code>item.template</code></li>

  154. <li><code>about.md</code></li>

  155. <li><code>cv.md</code></li></ul></li>

  156. <li><code>ru/blog/</code><ul>

  157. <li><code>item.template</code></li>

  158. <li><code>index.template</code></li>

  159. <li><code>preview.template</code></li>

  160. <li><code>pagination.template</code></li>

  161. <li><code>pagination.prev.template</code></li>

  162. <li><code>pagination.next.template</code></li>

  163. <li><code>1885.md</code></li>

  164. <li><code>1886.01.md</code></li>

  165. <li><code>1886.02.md</code></li>

  166. <li><code>1887.01.md</code></li>

  167. <li><code>1887.02.md</code></li>

  168. <li><code>1888.md</code></li>

  169. <li><code>1896.md</code></li>

  170. <li><code>1899.md</code></li></ul></li>

  171. <li><code>ru/page/</code><ul>

  172. <li><code>item.template</code></li>

  173. <li><code>about.md</code></li>

  174. <li><code>cv.md</code></li></ul></li>

  175. </ul>

  176. <p>Let's look at the contents of these files closer.</p>

  177. <p><a name="cfg"/></p>

  178. <h2 id="02investigatepskovcfgfile">02. Investigate <code>pskov.cfg</code> file</h2>

  179. <p><code>pskov.cfg</code> file has the following contents:</p>

  180. <pre><code>input = en/page;ru/page;en/blog;ru/blog

  181. item = item.template

  182. preview = preview.template

  183. index = index.template

  184. paginationPrev = pagination.prev.template

  185. paginationNext = pagination.next.template

  186. paginationPrevNext = pagination.template

  187. previewSize = 200

  188. previewEnding = . . .

  189. previewsPerPage = 3

  190. previewPageBaseName = index

  191. </code></pre>

  192. <p>You already met <code>input</code> and <code>item</code> keys. Let's see into new ones:</p>

  193. <table>

  194. <thead>

  195. <tr>

  196. <th>Key</th>

  197. <th>Description</th>

  198. </tr>

  199. </thead>

  200. <tbody>

  201. <tr>

  202. <td><code>preview</code></td>

  203. <td>Points to an HTML template that is used to generate HTML preview out of the first <code>previewSize</code> (approximately) characters for each Markdown file</td>

  204. </tr>

  205. <tr>

  206. <td><code>index</code></td>

  207. <td>Points to an HTML template that is used to generate preview page to host previews</td>

  208. </tr>

  209. <tr>

  210. <td><code>paginationPrev</code></td>

  211. <td>Points to an HTML template that is used to generate pagination section to navigate backwards</td>

  212. </tr>

  213. <tr>

  214. <td><code>paginationNext</code></td>

  215. <td>Points to an HTML template that is used to generate pagination section to navigate forward</td>

  216. </tr>

  217. <tr>

  218. <td><code>paginationPrevNext</code></td>

  219. <td>Points to an HTML template that is used to generate pagination section</td>

  220. </tr>

  221. <tr>

  222. <td><code>previewSize</code></td>

  223. <td>How many characters (approximately) to take out of a Markdown file to generate a preview</td>

  224. </tr>

  225. <tr>

  226. <td><code>previewEnding</code></td>

  227. <td>String to use at the end of each preview</td>

  228. </tr>

  229. <tr>

  230. <td><code>previewsPerPage</code></td>

  231. <td>Maximum number of previews hosted by a preview page</td>

  232. </tr>

  233. <tr>

  234. <td><code>previewsPageBaseName</code></td>

  235. <td>Base file name for preview pages</td>

  236. </tr>

  237. </tbody>

  238. </table>

  239. <p>In our case:</p>

  240. <ul>

  241. <li>we restrict previews to <code>200</code> characters in size (approximately)</li>

  242. <li>we use <code>. . .</code> string at the end of each preview</li>

  243. <li>preview pages host <code>3</code> previews maximum</li>

  244. <li>preview pages are saved as <code>index.html</code>, <code>index2.html</code>, <code>index3.html</code>, etc.</li>

  245. </ul>

  246. <p><a name="item"/></p>

  247. <h2 id="03investigateitemtemplatesoftheblog">03. Investigate item templates of the blog</h2>

  248. <ul>

  249. <li><p><code>en/blog/item.template</code> contents:</p>

  250. <pre><code>- - - - Collapsed for brevity - - - -

  251. &lt;body&gt;

  252.     &lt;div id="header"&gt;

  253.         &lt;strong&gt;Serov&lt;/strong&gt;

  254.         &lt;a href="../../en/blog/index.html"&gt;Blog&lt;/a&gt;

  255.         &lt;a href="../../en/page/about.html"&gt;About me&lt;/a&gt;

  256.         &lt;a href="../../en/page/cv.html"&gt;CV&lt;/a&gt;

  257.         &lt;div id="lang"&gt;

  258.             &lt;a href="../../en/blog/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;

  259.             &lt;a href="../../ru/blog/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;

  260.         &lt;/div&gt;

  261.     &lt;/div&gt;

  262.     &lt;center&gt;

  263.         &lt;h1&gt;In the blog...&lt;/h1&gt;

  264.         &lt;div class="contents"&gt;

  265.             &lt;h2 class="itemTitle"&gt;

  266.                 &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;

  267.             &lt;/h2&gt;

  268.             &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;

  269. PSKOV_ITEM_CONTENTS

  270.         &lt;/div&gt;

  271.         &lt;div id="footer"&gt;

  272.             This sample web site has been generated by &lt;a href="http://opengamestudio.org/pskov"&gt;PSKOV&lt;/a&gt;.

  273.         &lt;/div&gt;

  274.     &lt;/center&gt;

  275. &lt;/body&gt;

  276. - - - - Collapsed for brevity - - - -

  277. </code></pre></li>

  278. <li><p><code>ru/blog/item.template</code> contents:</p>

  279. <pre><code>- - - - Collapsed for brevity - - - -

  280. &lt;body&gt;

  281.     &lt;div id="header"&gt;

  282.         &lt;strong&gt;Серов&lt;/strong&gt;

  283.         &lt;a href="../../ru/blog/index.html"&gt;Блог&lt;/a&gt;

  284.         &lt;a href="../../ru/page/about.html"&gt;Обо мне&lt;/a&gt;

  285.         &lt;a href="../../ru/page/cv.html"&gt;Резюме&lt;/a&gt;

  286.         &lt;div id="lang"&gt;

  287.             &lt;a href="../../en/blog/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;

  288.             &lt;a href="../../ru/blog/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;

  289.         &lt;/div&gt;

  290.     &lt;/div&gt;

  291.     &lt;center&gt;

  292.         &lt;h1&gt;В блоге...&lt;/h1&gt;

  293.         &lt;div class="contents"&gt;

  294.             &lt;h2 class="itemTitle"&gt;

  295.                 &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;

  296.             &lt;/h2&gt;

  297.             &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;

  298. PSKOV_ITEM_CONTENTS

  299.         &lt;/div&gt;

  300.         &lt;div id="footer"&gt;

  301.             Этот пример сайта сгенерирован &lt;a href="http://opengamestudio.org/pskov"&gt;ПСКОВОМ&lt;/a&gt;.

  302.         &lt;/div&gt;

  303.     &lt;/center&gt;

  304. &lt;/body&gt;

  305. - - - - Collapsed for brevity - - - -

  306. </code></pre></li>

  307. </ul>

  308. <p><strong>Note</strong>: beginning and ending were collapsed for brevity.</p>

  309. <p>As you can see, both files look similar to <code>item.template</code> files we saw <a href="education.04.lang.html">before</a>.</p>

  310. <p>The changes include:</p>

  311. <ul>

  312. <li>new URLs to reference pages in <code>page</code> directory and the first preview page in <code>blog</code> directory</li>

  313. <li>title is referenced inside <code>contents</code> section as a link pointing to a complete blog post</li>

  314. <li>date is referenced to highlight relationship among different blog posts in time</li>

  315. </ul>

  316. <p>Date reference uses new <code>PSKOV_ITEM_DATE</code> constant:</p>

  317. <table>

  318. <thead>

  319. <tr>

  320. <th>PSKOV constant</th>

  321. <th>Description</th>

  322. </tr>

  323. </thead>

  324. <tbody>

  325. <tr>

  326. <td><code>PSKOV_ITEM_DATE</code></td>

  327. <td>Value of <code>Date</code> key of the page's Markdown file</td>

  328. </tr>

  329. </tbody>

  330. </table>

  331. <p><a name="preview"/></p>

  332. <h2 id="04investigatepreviewtemplates">04. Investigate preview templates</h2>

  333. <ul>

  334. <li><p><code>en/blog/preview.template</code> contents:</p>

  335. <pre><code>&lt;div class="contents"&gt;

  336.     &lt;h2 class="itemTitle"&gt;

  337.         &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;

  338.     &lt;/h2&gt;

  339.     &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;

  340. PSKOV_PREVIEW

  341.     &lt;div class="itemMore"&gt;

  342.         &lt;a href="PSKOV_ITEM_URL"&gt;Continue reading&lt;/a&gt;

  343.     &lt;/div&gt;

  344. &lt;/div&gt;

  345. </code></pre></li>

  346. <li><p><code>ru/blog/preview.template</code> contents:</p>

  347. <pre><code>&lt;div class="contents"&gt;

  348.     &lt;h2 class="itemTitle"&gt;

  349.         &lt;a href="PSKOV_ITEM_URL"&gt;PSKOV_ITEM_TITLE&lt;/a&gt;

  350.     &lt;/h2&gt;

  351.     &lt;p class="itemDate"&gt;PSKOV_ITEM_DATE&lt;/p&gt;

  352. PSKOV_PREVIEW

  353.     &lt;div class="itemMore"&gt;

  354.         &lt;a href="PSKOV_ITEM_URL"&gt;Читать дальше&lt;/a&gt;

  355.     &lt;/div&gt;

  356. &lt;/div&gt;

  357. </code></pre></li>

  358. </ul>

  359. <p>Previews have no <code>&lt;head&gt;</code>, <code>&lt;body&gt;</code>, and similar full page HTML tags. Previews represent sections inserted into preview pages.</p>

  360. <p>Preview itself is referenced by <code>PSKOV_PREVIEW</code> constant:</p>

  361. <table>

  362. <thead>

  363. <tr>

  364. <th>PSKOV constant</th>

  365. <th>Description</th>

  366. </tr>

  367. </thead>

  368. <tbody>

  369. <tr>

  370. <td><code>PSKOV_PREVIEW</code></td>

  371. <td>Provides contents of a Markdown file limited by <code>previewSize</code> characters (approximately)</td>

  372. </tr>

  373. </tbody>

  374. </table>

  375. <p><a name="index"/></p>

  376. <h2 id="05investigatetemplatesofpreviewpages">05. Investigate templates of preview pages</h2>

  377. <ul>

  378. <li><p><code>en/blog/index.template</code> contents:</p>

  379. <pre><code>- - - - Collapsed for brevity - - - -

  380. &lt;body&gt;

  381.     &lt;div id="header"&gt;

  382.         &lt;strong&gt;Serov&lt;/strong&gt;

  383.         &lt;a href="../../en/blog/index.html"&gt;Blog&lt;/a&gt;

  384.         &lt;a href="../../en/page/about.html"&gt;About me&lt;/a&gt;

  385.         &lt;a href="../../en/page/cv.html"&gt;CV&lt;/a&gt;

  386.         &lt;div id="lang"&gt;

  387.             &lt;a href="../../en/blog/PSKOV_INDEX_URL"&gt;EN&lt;/a&gt;

  388.             &lt;a href="../../ru/blog/PSKOV_INDEX_URL"&gt;RU&lt;/a&gt;

  389.         &lt;/div&gt;

  390.     &lt;/div&gt;

  391.     &lt;center&gt;

  392.         &lt;h1&gt;Blog&lt;/h1&gt;

  393. PSKOV_PREVIEWS

  394. PSKOV_PAGINATION

  395.         &lt;div id="footer"&gt;

  396.             This sample web site has been generated by &lt;a href="http://opengamestudio.org/pskov"&gt;PSKOV&lt;/a&gt;.

  397.         &lt;/div&gt;

  398.     &lt;/center&gt;

  399. &lt;/body&gt;

  400. - - - - Collapsed for brevity - - - -

  401. </code></pre></li>

  402. <li><p><code>ru/blog/index.template</code> contents:</p>

  403. <pre><code>- - - - Collapsed for brevity - - - -

  404. &lt;body&gt;

  405.     &lt;div id="header"&gt;

  406.         &lt;strong&gt;Серов&lt;/strong&gt;

  407.         &lt;a href="../../ru/blog/index.html"&gt;Блог&lt;/a&gt;

  408.         &lt;a href="../../ru/page/about.html"&gt;Обо мне&lt;/a&gt;

  409.         &lt;a href="../../ru/page/cv.html"&gt;Резюме&lt;/a&gt;

  410.         &lt;div id="lang"&gt;

  411.             &lt;a href="../../en/blog/PSKOV_INDEX_URL"&gt;EN&lt;/a&gt;

  412.             &lt;a href="../../ru/blog/PSKOV_INDEX_URL"&gt;RU&lt;/a&gt;

  413.         &lt;/div&gt;

  414.     &lt;/div&gt;

  415.     &lt;center&gt;

  416.         &lt;h1&gt;Блог&lt;/h1&gt;

  417. PSKOV_PREVIEWS

  418. PSKOV_PAGINATION

  419.         &lt;div id="footer"&gt;

  420.             Этот пример сайта сгенерирован &lt;a href="http://opengamestudio.org/pskov"&gt;ПСКОВОМ&lt;/a&gt;.

  421.         &lt;/div&gt;

  422.     &lt;/center&gt;

  423. &lt;/body&gt;

  424. - - - - Collapsed for brevity - - - -

  425. </code></pre></li>

  426. </ul>

  427. <p><strong>Notes</strong>:</p>

  428. <ul>

  429. <li>beginning and ending were collapsed for brevity</li>

  430. <li><code>PSKOV_INDEX_URL</code> constant is used to provide language selection</li>

  431. </ul>

  432. <p>Here are new <strong>PSKOV</strong> constants explained:</p>

  433. <table>

  434. <thead>

  435. <tr>

  436. <th>PSKOV constant</th>

  437. <th>Description</th>

  438. </tr>

  439. </thead>

  440. <tbody>

  441. <tr>

  442. <td><code>PSKOV_INDEX_URL</code></td>

  443. <td>Provides generated preview page file name: <code>&lt;previewsPageBaseName&gt;&lt;id&gt;.html</code></td>

  444. </tr>

  445. <tr>

  446. <td><code>PSKOV_PREVIEWS</code></td>

  447. <td>Provides a set of previews</td>

  448. </tr>

  449. <tr>

  450. <td><code>PSKOV_PAGINATION</code></td>

  451. <td>Provides pagination section to navigate preview pages</td>

  452. </tr>

  453. </tbody>

  454. </table>

  455. <p><a name="pagination"/></p>

  456. <h2 id="06investigatepaginationtemplates">06. Investigate pagination templates</h2>

  457. <p>Pagination templates represent HTML sections to navigate preview pages.</p>

  458. <p>There are free pagination templates:</p>

  459. <table>

  460. <thead>

  461. <tr>

  462. <th>Pagination template</th>

  463. <th>Description</th>

  464. </tr>

  465. </thead>

  466. <tbody>

  467. <tr>

  468. <td>Previous</td>

  469. <td>A visitor can only go backwards</td>

  470. </tr>

  471. <tr>

  472. <td>Next</td>

  473. <td>A visitor can only go forward</td>

  474. </tr>

  475. <tr>

  476. <td>Both</td>

  477. <td>A visitor can either go backwards, or forward</td>

  478. </tr>

  479. </tbody>

  480. </table>

  481. <p>Let's look at English pagination templates:</p>

  482. <ul>

  483. <li><p><code>en/blog/pagination.prev.template</code> contents:</p>

  484. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;

  485. &lt;p&gt;

  486.     &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Newer&lt;/a&gt;

  487. &lt;/p&gt;

  488. </code></pre></li>

  489. <li><p><code>en/blog/pagination.next.template</code> contents:</p>

  490. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;

  491. &lt;p&gt;

  492.     &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Older »&lt;/a&gt;

  493. &lt;/p&gt;

  494. </code></pre></li>

  495. <li><p><code>en/blog/pagination.template</code> contents:</p>

  496. <pre><code>&lt;p&gt;Page PSKOV_PAGE_ID of PSKOV_PAGES_COUNT&lt;/p&gt;

  497. &lt;p&gt;

  498.     &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Newer&lt;/a&gt;

  499.     &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Older »&lt;/a&gt;

  500. &lt;/p&gt;

  501. </code></pre></li>

  502. </ul>

  503. <p>Russian counterparts look similar. Here's <code>ru/blog/pagination.template</code> contents:</p>

  504. <pre><code>&lt;p&gt;Страница PSKOV_PAGE_ID из PSKOV_PAGES_COUNT&lt;/p&gt;

  505. &lt;p&gt;

  506.     &lt;a href="PSKOV_PREV_PAGE_URL"&gt;« Новее&lt;/a&gt;

  507.     &lt;a href="PSKOV_NEXT_PAGE_URL"&gt;Старее »&lt;/a&gt;

  508. &lt;/p&gt;

  509. </code></pre>

  510. <p>Here are new <strong>PSKOV</strong> constants we used:</p>

  511. <table>

  512. <thead>

  513. <tr>

  514. <th>PSKOV constant</th>

  515. <th>Description</th>

  516. </tr>

  517. </thead>

  518. <tbody>

  519. <tr>

  520. <td><code>PSKOV_PAGE_ID</code></td>

  521. <td>Provides preview page id starting from <code>1</code></td>

  522. </tr>

  523. <tr>

  524. <td><code>PSKOV_PAGES_COUNT</code></td>

  525. <td>Provides total number of generated preview pages</td>

  526. </tr>

  527. <tr>

  528. <td><code>PSKOV_PREV_PAGE_URL</code></td>

  529. <td>Provides previous preview page file name</td>

  530. </tr>

  531. <tr>

  532. <td><code>PSKOV_NEXT_PAGE_URL</code></td>

  533. <td>Provides next preview page file name</td>

  534. </tr>

  535. </tbody>

  536. </table>

  537. <p><a name="md"/></p>

  538. <h2 id="07investigatemarkdownfiles">07. Investigate Markdown files</h2>

  539. <p>Markdown files represent blog posts and they look almost like Markdown files for pages. Here's <code>en/blog/1885.md</code> contents:</p>

  540. <pre><code> Title: Bullocks

  541.  Date: 1885

  542.  Slug: 1885.01.bullocks

  543. 

  544.  ![Bullocks][bullocks]

  545. 

  546.  I've been painting "Bullocks" sketch while I was staying in Odessa at Kuznetsov's in 1885.

  547. 

  548.  [bullocks]: https://upload.wikimedia.org/wikipedia/commons/c/cb/Walentin_Aleksandrovich_Serov_Bullocks.jpg

  549. </code></pre>

  550. <p>Date is used to sort blog posts by date in descending order:</p>

  551. <table>

  552. <thead>

  553. <tr>

  554. <th>Header key</th>

  555. <th>Description</th>

  556. </tr>

  557. </thead>

  558. <tbody>

  559. <tr>

  560. <td><code>Date</code></td>

  561. <td>Provides value for <code>PSKOV_ITEM_DATE</code> constant when generating HTML out of Markdown</td>

  562. </tr>

  563. </tbody>

  564. </table>

  565. <p><a name="lfsa"/></p>

  566. <h2 id="08launchlfsa">08. Launch LFSA</h2>

  567. <video controls poster="../vid/education.05.blog.launch-lfsa.edgy.poster.png">

  568.     <source src="../vid/education.05.blog.launch-lfsa.edgy.mp4" type ="video/mp4">

  569.     <source src="../vid/education.05.blog.launch-lfsa.edgy.webm" type ="video/webm">

  570.     ERROR Your browser does not support HTML5 video

  571. </video>

  572. <p>Launch <a href="http://opengamestudio.org/lfsa">LFSA</a> so that it points to directory with the files we just observed:</p>

  573. <pre><code>$ /path/to/lfsa_1.0.0.py /path/to/dir/03.Blog

  574. </code></pre>

  575. <p><a name="gen"/></p>

  576. <h2 id="09generatethesite">09. Generate the site</h2>

  577. <video controls poster="../vid/education.05.blog.gen.edgy.poster.png">

  578.     <source src="../vid/education.05.blog.gen.edgy.mp4" type ="video/mp4">

  579.     <source src="../vid/education.05.blog.gen.edgy.webm" type ="video/webm">

  580.     ERROR Your browser does not support HTML5 video

  581. </video>

  582. <p>Go to <a href="http://opengamestudio.org/pskov">Tool</a> page and press <code>Generate</code> button to generate HTML files right where Markdown ones reside.</p>

  583. <p><a name="observe"/></p>

  584. <h2 id="10observethesite">10. Observe the site</h2>

  585. <video controls poster="../vid/education.05.blog.observe.edgy.poster.png">

  586.     <source src="../vid/education.05.blog.observe.edgy.mp4" type ="video/mp4">

  587.     <source src="../vid/education.05.blog.observe.edgy.webm" type ="video/webm">

  588.     ERROR Your browser does not support HTML5 video

  589. </video>

  590. <p>Observe generated web site locally by opening <code>en/blog/index.html</code> or <code>ru/blog/index.html</code> and navigating preview pages.</p>

  591. <p><a name="summary"/></p>

  592. <h2 id="11summary">11. Summary</h2>

  593. <p>You have successfully generated a web site with "dynamic" blog posts. <a href="http://opengamestudio.org/pskov/sample/03.Blog/en/blog/index.html">Check out the result</a>.</p>

  594. <p>Introduced PSKOV constants include:</p>

  595. <table>

  596. <thead>

  597. <tr>

  598. <th>PSKOV constant</th>

  599. <th>Description</th>

  600. </tr>

  601. </thead>

  602. <tbody>

  603. <tr>

  604. <td><code>PSKOV_ITEM_DATE</code></td>

  605. <td>Value of <code>Date</code> key of the page's Markdown file</td>

  606. </tr>

  607. <tr>

  608. <td><code>PSKOV_PREVIEW</code></td>

  609. <td>Provides contents of a Markdown file limited by <code>previewSize</code> characters (approximately)</td>

  610. </tr>

  611. <tr>

  612. <td><code>PSKOV_INDEX_URL</code></td>

  613. <td>Provides generated preview page file name: <code>&lt;previewsPageBaseName&gt;&lt;id&gt;.html</code></td>

  614. </tr>

  615. <tr>

  616. <td><code>PSKOV_PREVIEWS</code></td>

  617. <td>Provides a set of previews</td>

  618. </tr>

  619. <tr>

  620. <td><code>PSKOV_PAGINATION</code></td>

  621. <td>Provides pagination section to navigate preview pages</td>

  622. </tr>

  623. <tr>

  624. <td><code>PSKOV_PAGE_ID</code></td>

  625. <td>Provides preview page id starting from <code>1</code></td>

  626. </tr>

  627. <tr>

  628. <td><code>PSKOV_PAGES_COUNT</code></td>

  629. <td>Provides total number of generated preview pages</td>

  630. </tr>

  631. <tr>

  632. <td><code>PSKOV_PREV_PAGE_URL</code></td>

  633. <td>Provides previous preview page file name</td>

  634. </tr>

  635. <tr>

  636. <td><code>PSKOV_NEXT_PAGE_URL</code></td>

  637. <td>Provides next preview page file name</td>

  638. </tr>

  639. </tbody>

  640. </table>

  641. <p>Introduced configuration keys include:</p>

  642. <table>

  643. <thead>

  644. <tr>

  645. <th>Key</th>

  646. <th>Description</th>

  647. </tr>

  648. </thead>

  649. <tbody>

  650. <tr>

  651. <td><code>preview</code></td>

  652. <td>Points to an HTML template that is used to generate HTML preview out of the first <code>previewSize</code> (approximately) characters for each Markdown file</td>

  653. </tr>

  654. <tr>

  655. <td><code>index</code></td>

  656. <td>Points to an HTML template that is used to generate preview page to host previews</td>

  657. </tr>

  658. <tr>

  659. <td><code>paginationPrev</code></td>

  660. <td>Points to an HTML template that is used to generate pagination section to navigate backwards</td>

  661. </tr>

  662. <tr>

  663. <td><code>paginationNext</code></td>

  664. <td>Points to an HTML template that is used to generate pagination section to navigate forward</td>

  665. </tr>

  666. <tr>

  667. <td><code>paginationPrevNext</code></td>

  668. <td>Points to an HTML template that is used to generate pagination section</td>

  669. </tr>

  670. <tr>

  671. <td><code>previewSize</code></td>

  672. <td>How many characters (approximately) to take out of a Markdown file to generate a preview</td>

  673. </tr>

  674. <tr>

  675. <td><code>previewEnding</code></td>

  676. <td>String to use at the end of each preview</td>

  677. </tr>

  678. <tr>

  679. <td><code>previewsPerPage</code></td>

  680. <td>Maximum number of previews hosted by a preview page</td>

  681. </tr>

  682. <tr>

  683. <td><code>previewsPageBaseName</code></td>

  684. <td>Base file name for preview pages</td>

  685. </tr>

  686. </tbody>

  687. </table>

  688. <p>Introduced header keys include:</p>

  689. <table>

  690. <thead>

  691. <tr>

  692. <th>Header key</th>

  693. <th>Description</th>

  694. </tr>

  695. </thead>

  696. <tbody>

  697. <tr>

  698. <td><code>Date</code></td>

  699. <td>Provides value for <code>PSKOV_ITEM_DATE</code> constant when generating HTML out of Markdown</td>

  700. </tr>

  701. </tbody>

  702. </table>

  703. <p>This was the final document to make you proficient in generating static sites with <strong>PSKOV</strong>. If you like what we do, join us at <a href="https://vk.com/opengamestudo">VK</a>, <a href="https://twitter.com/OpenGameStudio">Twitter</a>, or <a href="https://www.facebook.com/groups/162611230470183">Facebook</a>.</p>

  704. <p>Now use <strong>PSKOV</strong> to generate your very own web site!</p>

  705. <p></div><div class="contents"></p>

  706. <table>

  707. <thead>

  708. <tr>

  709. <th>&lt; Back</th>

  710. <th>Index</th>

  711. <th>Next &gt;</th>

  712. </tr>

  713. </thead>

  714. <tbody>

  715. <tr>

  716. <td><a href="education.04.lang.html">04. Language</a></td>

  717. <td><a href="education.html">Education</a></td>

  718. <td>Not available</td>

  719. </tr>

  720. </tbody>

  721. </table>

  722.         </div></center>

  723.         <div id="footer">

  724.             The site has been generated by <a href="http://opengamestudio.org/pskov">PSKOV</a>

  725.             from <a href="http://github.com/ogstudio/site-pskov">this source code</a>.

  726.             The site is hosted by <a href="https://pages.github.com">GitHub Pages</a>.

  727.         </div>

  728.         <script type="text/javascript">

  729.         </script>

  730.     </body>

  731. </html>