Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.

education.04.lang.html 13KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301
  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.04.lang.html">EN</a>
  89. <a href="../ru/education.04.lang.html">RU</a>
  90. </div>
  91. </div>
  92. <center><h1>
  93. Обучение: 04. Язык
  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.03.site.html">03. Сайт</a></td>
  107. <td><a href="education.html">Обучение</a></td>
  108. <td><a href="education.05.blog.html">05. Блог</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="#localization">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="#md">04. Изучите файлы Markdown</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="localization"/></p>
  127. <h2 id="01">01. Локализация</h2>
  128. <p>Теперь, когда у вас есть собственный веб-сайт на английском, вы задумываетесь о русской версии, ведь вы же всё-таки русский!</p>
  129. <p>Вы создаёте директорию со <a href="https://github.com/OGStudio/site-pskov-sample/tree/master/02.Language">следующей структурой файлов</a>:</p>
  130. <ul>
  131. <li><code>pskov.cfg</code></li>
  132. <li><code>en/item.template</code></li>
  133. <li><code>en/about.md</code></li>
  134. <li><code>en/cv.md</code></li>
  135. <li><code>ru/item.template</code></li>
  136. <li><code>ru/about.md</code></li>
  137. <li><code>ru/cv.md</code></li>
  138. </ul>
  139. <p>Давайте взглянем на содержимое этих файлов.</p>
  140. <p><a name="cfg"/></p>
  141. <h2 id="02pskovcfg">02. Изучите файл <code>pskov.cfg</code></h2>
  142. <p>Файл <code>pskov.cfg</code> содержит следующее:</p>
  143. <pre><code>input = en;ru
  144. item = item.template
  145. </code></pre>
  146. <p>Как видите, <code>input</code> может принимать несколько директорий, разделённых символом <code>;</code>. <strong>ПСКОВ</strong> обработает каждую указанную директорию так же, как и ранее.</p>
  147. <p>В нашем случае каждая из директорий - <code>en/</code> и <code>ru/</code> - содержит собственный шаблон <code>item.template</code>.</p>
  148. <p><a name="item"/></p>
  149. <h2 id="03">03. Изучите файлы шаблонов</h2>
  150. <ul>
  151. <li><p>Содержимое <code>en/item.template</code>:</p>
  152. <pre><code>- - - - Схлопнуто для краткости - - - -
  153. &lt;title&gt;Serov&lt;/title&gt;
  154. &lt;/head&gt;
  155. &lt;body&gt;
  156. &lt;div id="header"&gt;
  157. &lt;strong&gt;Serov&lt;/strong&gt;
  158. &lt;a href="about.html"&gt;About me&lt;/a&gt;
  159. &lt;a href="cv.html"&gt;CV&lt;/a&gt;
  160. &lt;div id="lang"&gt;
  161. &lt;a href="../en/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;
  162. &lt;a href="../ru/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;
  163. &lt;/div&gt;
  164. &lt;/div&gt;
  165. &lt;center&gt;
  166. - - - - Схлопнуто для краткости - - - -
  167. </code></pre></li>
  168. <li><p>Содержимое <code>ru/item.template</code>:</p>
  169. <pre><code>- - - - Схлопнуто для краткости - - - -
  170. &lt;title&gt;Серов&lt;/title&gt;
  171. &lt;/head&gt;
  172. &lt;body&gt;
  173. &lt;div id="header"&gt;
  174. &lt;strong&gt;Серов&lt;/strong&gt;
  175. &lt;a href="about.html"&gt;Обо мне&lt;/a&gt;
  176. &lt;a href="cv.html"&gt;Резюме&lt;/a&gt;
  177. &lt;div id="lang"&gt;
  178. &lt;a href="../en/PSKOV_ITEM_URL"&gt;EN&lt;/a&gt;
  179. &lt;a href="../ru/PSKOV_ITEM_URL"&gt;RU&lt;/a&gt;
  180. &lt;/div&gt;
  181. &lt;/div&gt;
  182. &lt;center&gt;
  183. - - - - Схлопнуто для краткости - - - -
  184. </code></pre></li>
  185. </ul>
  186. <p><strong>Внимание</strong>: начало и конец схлопнуты для краткости.</p>
  187. <p>Как видите, <code>en/item.template</code> и <code>ru/item.template</code> очень похожи на <a href="education.03.site.html">виденный ранее</a> <code>item.template</code>.</p>
  188. <p>Изменения следующие:</p>
  189. <ul>
  190. <li>использование секции <code>&lt;div id="lang"&gt;...&lt;/div&gt;</code> для отображения выбора языка</li>
  191. <li>локализация заголовков на Английском и Русском языках</li>
  192. </ul>
  193. <p>Выбор языка использует следующую новую константу <strong>ПСКОВА</strong>:</p>
  194. <table>
  195. <thead>
  196. <tr>
  197. <th>Константа ПСКОВА</th>
  198. <th>Описание</th>
  199. </tr>
  200. </thead>
  201. <tbody>
  202. <tr>
  203. <td><code>PSKOV_ITEM_URL</code></td>
  204. <td>Предоставляет имя файла генерируемой страницы</td>
  205. </tr>
  206. </tbody>
  207. </table>
  208. <p>Использование <code>PSKOV_ITEM_URL</code> даёт вам поддержку стольких языков, сколько пожелаете.</p>
  209. <p><a name="md"/></p>
  210. <h2 id="04markdown">04. Изучите файлы Markdown</h2>
  211. <p>Файлы <code>en/about.md</code> и <code>en/cv.md</code> выглядят почти идентично <a href="education.03.site.html">виденным ранее</a>. <code>ru/about.md</code> и <code>ru/cv.md</code> представляют собой русские версии соответствующих английских страниц.</p>
  212. <p>Например, <code>ru/cv.md</code> содержит:</p>
  213. <pre><code> Title: Резюме
  214. Slug: cv
  215. Здесь вы можете увидеть моё резюме в том случае, если мои произведения всё ещё вас интересуют. Я использовал современный подход ИТ для структурирования своего резюме в виде пар ключ-значение словаря (карты). Наслаждайтесь!
  216. | Ключ | Значение |
  217. |---|---|
  218. | Имя | Валентин Серов |
  219. | Возраст | 46 |
  220. | Семейное положение | Женат |
  221. | Страна | Российская Империя |
  222. | Учёба | Императорская Академия художеств |
  223. | Звания | * академик ИАХ (1898) &lt;br&gt; * действительный член ИАХ (1903) |
  224. </code></pre>
  225. <p><strong>Внимание</strong>: русская страница использует точно такое же значение <code>Slug</code>, как и английская страница.</p>
  226. <p><a name="lfsa"/></p>
  227. <h2 id="05">05. Запустите ЛФСД</h2>
  228. <video controls poster="../vid/education.04.lang.launch-lfsa.edgy.poster.png">
  229. <source src="../vid/education.04.lang.launch-lfsa.edgy.mp4" type ="video/mp4">
  230. <source src="../vid/education.04.lang.launch-lfsa.edgy.webm" type ="video/webm">
  231. ОШИБКА Ваш браузер не поддерживает видео HTML5
  232. </video>
  233. <p>Запустите <a href="http://opengamestudio.org/lfsa/ru">ЛФСД</a> с указанием директории, содержащей только что рассмотренные файлы:</p>
  234. <pre><code>$ /путь/до/lfsa_1.0.0.py /путь/до/директории/02.Language
  235. </code></pre>
  236. <p><a name="gen"/></p>
  237. <h2 id="06">06. Сгенерируйте сайт</h2>
  238. <video controls poster="../vid/education.04.lang.gen.edgy.poster+ru.png">
  239. <source src="../vid/education.04.lang.gen.edgy+ru.mp4" type ="video/mp4">
  240. <source src="../vid/education.04.lang.gen.edgy+ru.webm" type ="video/webm">
  241. ОШИБКА Ваш браузер не поддерживает видео HTML5
  242. </video>
  243. <p>Перейдите на страницу <a href="http://opengamestudio.org/pskov/ru/pskov_1.0.0+ru.html">Инструмент</a> и нажмите кнопку <code>Генерировать</code> для генерации файлов HTML рядом с файлами Markdown.</p>
  244. <p><a name="observe"/></p>
  245. <h2 id="07">07. Проверьте сайт</h2>
  246. <video controls poster="../vid/education.04.lang.observe.edgy.poster+ru.png">
  247. <source src="../vid/education.04.lang.observe.edgy.mp4" type ="video/mp4">
  248. <source src="../vid/education.04.lang.observe.edgy.webm" type ="video/webm">
  249. ОШИБКА Ваш браузер не поддерживает видео HTML5
  250. </video>
  251. <p>Проверьте сгенерированный веб-сайт локально: откройте файл <code>ru/about.html</code> или <code>en/about.html</code> и переключите язык.</p>
  252. <p><a name="summary"/></p>
  253. <h2 id="08">08. Итог</h2>
  254. <p>Вы успешно добавили выбор языка. <a href="http://opengamestudio.org/pskov/sample/02.Language/ru/about.html">Проверьте результат</a>.</p>
  255. <p>Представлены константы <strong>ПСКОВА</strong>:</p>
  256. <table>
  257. <thead>
  258. <tr>
  259. <th>Константа ПСКОВА</th>
  260. <th>Описание</th>
  261. </tr>
  262. </thead>
  263. <tbody>
  264. <tr>
  265. <td><code>PSKOV_ITEM_URL</code></td>
  266. <td>Предоставляет имя файла генерируемой страницы</td>
  267. </tr>
  268. </tbody>
  269. </table>
  270. <p></div><div class="contents"></p>
  271. <table>
  272. <thead>
  273. <tr>
  274. <th>&lt; Назад</th>
  275. <th>Начало</th>
  276. <th>Далее &gt;</th>
  277. </tr>
  278. </thead>
  279. <tbody>
  280. <tr>
  281. <td><a href="education.03.site.html">03. Сайт</a></td>
  282. <td><a href="education.html">Обучение</a></td>
  283. <td><a href="education.05.blog.html">05. Блог</a></td>
  284. </tr>
  285. </tbody>
  286. </table>
  287. </div></center>
  288. <div id="footer">
  289. Сайт сгенерирован <a href="http://opengamestudio.org/pskov">ПСКОВОМ</a>
  290. из <a href="http://github.com/ogstudio/site-pskov">этого исходного кода</a>.
  291. Сайт расположен на <a href="https://pages.github.com">GitHub Pages</a>.
  292. </div>
  293. <script type="text/javascript">
  294. </script>
  295. </body>
  296. </html>