{"id":346330,"date":"2023-03-06T09:04:21","date_gmt":"2023-03-06T09:04:21","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=346330"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=346330","title":{"rendered":"<span>Docs as Code \u0434\u043b\u044f \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439 \u043b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u044b. \u0414\u0435\u043b\u0430\u0435\u043c \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0430\u0439\u0442 \u0440\u0435\u0431\u0435\u043d\u043a\u0430 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e MkDocs<\/span>"},"content":{"rendered":"<div><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-1\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/post_images\/cd2\/21e\/8c2\/cd221e8c2cbc1d5646284a1c9cf24d19.png\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/cd2\/21e\/8c2\/cd221e8c2cbc1d5646284a1c9cf24d19.png\"\/><\/p>\n<p>  <\/p>\n<p>Docs as \u0421ode \u2014 \u043f\u043e\u0434\u0445\u043e\u0434 \u043a \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0442\u0435\u043a\u0441\u0442\u0430\u043c\u0438, \u043f\u043e\u0434\u0440\u0430\u0437\u0443\u043c\u0435\u0432\u0430\u044e\u0449\u0438\u0439 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0442\u0435\u043a\u0441\u0442\u0430 \u043a\u0430\u043a \u043a\u043e\u0434\u0430:<\/p>\n<p>  <\/p>\n<ul>\n<li>\u0432 \u043f\u0440\u043e\u0441\u0442\u043e\u043c \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u043e\u043c \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435 \u0438\u043b\u0438 IDE;<\/li>\n<li>\u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u0438\u0441\u0442\u0435\u043c\u044b \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044f \u0432\u0435\u0440\u0441\u0438\u0439;<\/li>\n<li>\u0441 CI \/ CD \/ Code Review.<\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u0412 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0435 \u0432\u0440\u0435\u043c\u044f Docs as Code \u0448\u0438\u0440\u043e\u043a\u043e \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439, \u0434\u0430\u0432\u0430\u044f \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u043c \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044f\u043c \u0438 \u043f\u0440\u043e\u0435\u043a\u0442\u043d\u044b\u043c \u043a\u043e\u043c\u0430\u043d\u0434\u0430\u043c \u043c\u0430\u0441\u0441\u0443 \u0443\u0434\u043e\u0431\u0441\u0442\u0432 \u0438 \u043f\u0440\u0435\u0438\u043c\u0443\u0449\u0435\u0441\u0442\u0432.<\/p>\n<p>  <\/p>\n<p>\u041d\u043e \u0447\u0442\u043e \u0435\u0441\u043b\u0438 \u043f\u043e\u0439\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435, \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c \u0442\u0430\u043a\u043e\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u043d\u0435 \u0441 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u043c\u0438, \u0430 \u0441 \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u043c\u0438 \u0442\u0435\u043a\u0441\u0442\u0430\u043c\u0438? \u0427\u0442\u043e \u0435\u0441\u043b\u0438 \u0430\u0432\u0442\u043e\u0440 \u2014 \u043d\u0435 \u0442\u0435\u0445\u043d\u0430\u0440\u044c \u0438 \u043d\u0435 \u0430\u0439\u0442\u0438\u0448\u043d\u0438\u043a? \u041f\u0440\u043e\u0441\u0442\u043e \u044e\u043d\u044b\u0439 \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0449\u0438\u0439 \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u043e\u0431\u0443\u0435\u0442 \u043f\u0438\u0441\u0430\u0442\u044c \u043f\u0440\u043e\u0437\u0443 \u0438 \u0441\u0442\u0438\u0445\u0438 \u0440\u0443\u0447\u043a\u043e\u0439 \u043d\u0430 \u0431\u0443\u043c\u0430\u0433\u0435, \u0438 \u043d\u0430\u0434\u0435\u0435\u0442\u0441\u044f \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u044c \u0448\u0438\u0440\u043e\u043a\u0443\u044e \u043f\u0443\u0431\u043b\u0438\u043a\u0443 \u0441\u043e \u0441\u0432\u043e\u0438\u043c \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e\u043c?<\/p>\n<p>  <\/p>\n<p>\u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u044f \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u043e \u0442\u0430\u043a\u043e\u043c \u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0435 (\u0437\u0430\u0431\u0435\u0433\u0430\u044f \u0432\u043f\u0435\u0440\u0435\u0434, \u0443\u0434\u0430\u0447\u043d\u043e\u043c). \u041c\u043e\u0435\u0439 \u0434\u043e\u0447\u0435\u0440\u0438 11 \u043b\u0435\u0442, \u043e\u043d\u0430 \u043f\u0438\u0448\u0435\u0442 \u0441\u043a\u0430\u0437\u043a\u0438, \u0441\u0442\u0438\u0445\u0438 \u0438 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b. \u0427\u0442\u043e\u0431\u044b \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0435\u0435 \u0443\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u0435, \u044f \u043f\u043e\u043c\u043e\u0433 \u0435\u0439 \u0441\u043e\u0437\u0434\u0430\u0442\u044c \u043b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u043d\u044b\u0439 \u0441\u0430\u0439\u0442, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u043f\u043e\u0434\u0445\u043e\u0434 Docs as Code. \u041e\u043d\u0430 \u0443\u0441\u043f\u0435\u0448\u043d\u043e \u043e\u0441\u0432\u043e\u0438\u043b\u0430 \u043e\u0441\u043d\u043e\u0432\u044b Markdown \u0438 Git. \u0421\u0435\u0439\u0447\u0430\u0441 \u043e\u043d\u0430 \u0441\u0430\u043c\u043e\u0441\u0442\u043e\u044f\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u0443\u0431\u043b\u0438\u043a\u0443\u0435\u0442 \u043d\u043e\u0432\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u043d\u043e\u0432\u043e\u0441\u0442\u0438 \u043d\u0430 \u0441\u0432\u043e\u0435\u043c \u0441\u0430\u0439\u0442\u0435 <a href=\"https:\/\/lib-beliakova.github.io\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/<\/a>.<\/p>\n<p><a name=\"habracut\"><\/a>  <\/p>\n<p>\u041f\u0440\u043e\u0434\u0435\u043c\u043e\u043d\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u0434\u0430\u043b\u0435\u0435 \u0444\u0430\u0439\u043b\u044b \u0438 \u043a\u043e\u043d\u0444\u0438\u0433\u0438 \u043c\u043e\u0436\u043d\u043e \u0442\u0430\u043a\u0436\u0435 \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 <a href=\"https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/\" rel=\"nofollow noopener noreferrer\">https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/<\/a>.<\/p>\n<p>  <\/p>\n<h2 id=\"instrumenty\">\u0418\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u044b<\/h2>\n<p>  <\/p>\n<p>Docs as code \u2014 \u043d\u0435 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u044b\u0439 \u043d\u0430\u0431\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u0430 \u0441\u043a\u043e\u0440\u0435\u0435 <a href=\"https:\/\/www.writethedocs.org\/guide\/docs-as-code\/\" rel=\"nofollow noopener noreferrer\">&#171;\u0444\u0438\u043b\u043e\u0441\u043e\u0444\u0438\u044f&#187;<\/a>. \u0412\u044b\u0431\u043e\u0440 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u0441\u0430\u043c\u044b\u0439 \u0448\u0438\u0440\u043e\u043a\u0438\u0439. \u041d\u0435\u0434\u043e\u043b\u0433\u043e \u0434\u0443\u043c\u0430\u044f, \u044f \u0432\u0437\u044f\u043b \u0442\u043e, \u0441 \u0447\u0435\u043c \u043d\u0435\u0434\u0430\u0432\u043d\u043e \u0438\u043c\u0435\u043b \u0434\u0435\u043b\u043e \u043f\u043e \u0440\u0430\u0431\u043e\u0442\u0435 (\u044f \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c).<\/p>\n<p>  <\/p>\n<ul>\n<li>Markdown \u2014 \u044f\u0437\u044b\u043a \u0440\u0430\u0437\u043c\u0435\u0442\u043a\u0438.<\/li>\n<li>Git \u2014 \u0441\u0438\u0441\u0442\u0435\u043c\u0430 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044f \u0432\u0435\u0440\u0441\u0438\u0439.<\/li>\n<li>VS Code \u2014 IDE, \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440.<\/li>\n<li>MkDocs \u2014 \u0433\u0435\u043d\u0435\u0440\u0430\u0442\u043e\u0440 \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u0432\u0435\u0431-\u0441\u0430\u0439\u0442\u043e\u0432 \u0438\u0437 \u043d\u0430\u0431\u043e\u0440\u0430 Markdown-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432.<\/li>\n<li>Material for MkDocs \u2014 \u043f\u0440\u043e\u0434\u0432\u0438\u043d\u0443\u0442\u0430\u044f \u0442\u0435\u043c\u0430 \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044f \u0434\u043b\u044f MkDocs.<\/li>\n<li>Docker \u2014 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0438\u0437\u0430\u0442\u043e\u0440 \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u0439 (\u0434\u043b\u044f \u0443\u043f\u0440\u043e\u0449\u0435\u043d\u0438\u044f \u0437\u0430\u043f\u0443\u0441\u043a\u0430 MkDocs).<\/li>\n<li>GitHub \u2014 \u0432\u0441\u0435\u043c \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b\u0439 \u0432\u0435\u0431-\u0441\u0435\u0440\u0432\u0438\u0441 \u0434\u043b\u044f \u0445\u043e\u0441\u0442\u0438\u043d\u0433\u0430 Git-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u0432, \u0442\u0430\u043a\u0436\u0435 \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u044e\u0449\u0438\u0439 \u0431\u0435\u0441\u043f\u043b\u0430\u0442\u043d\u044b\u0439 \u0445\u043e\u0441\u0442\u0438\u043d\u0433 \u0441\u0442\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u0441\u0430\u0439\u0442\u043e\u0432 GitHub Pages \u0438 \u0441\u0438\u0441\u0442\u0435\u043c\u0443 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0437\u0430\u0446\u0438\u0438 \u0441\u0431\u043e\u0440\u043a\u0438 GitHub Actions.<\/li>\n<\/ul>\n<p>  <\/p>\n<h2 id=\"sozdanie-proekta-mkdocs\">\u0421\u043e\u0437\u0434\u0430\u043d\u0438\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 MkDocs<\/h2>\n<p>  <\/p>\n<p>\u041c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 &#171;\u043f\u0440\u043e\u0435\u043a\u0442&#187; MkDocs \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0442\u0430\u043a:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">. \u251c\u2500 docs\/ \u2502  \u2514\u2500 index.md \u2514\u2500 mkdocs.yml<\/code><\/pre>\n<p>  <\/p>\n<p>\u0415\u0433\u043e \u043c\u043e\u0436\u043d\u043e \u0441\u043e\u0437\u0434\u0430\u0442\u044c \u043a\u043e\u043c\u0430\u043d\u0434\u043e\u0439 <code>mkdocs new<\/code> \u0438\u043b\u0438 \u043f\u0440\u043e\u0441\u0442\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u044b\u0435 \u0444\u0430\u0439\u043b\u044b \u0432\u0440\u0443\u0447\u043d\u0443\u044e (\u0435\u0441\u043b\u0438 MkDocs \u043f\u043e\u043a\u0430 \u043d\u0435 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043b\u0435\u043d). \u0423\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c\u0438 \u043f\u0440\u043e\u0435\u043a\u0442\u0430 MkDocs \u043e\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u043e\u043d\u043d\u043e\u043c \u0444\u0430\u0439\u043b\u0435 <code>mkdocs.yaml<\/code> \u0432 \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u043f\u0430\u043f\u043a\u0435 \u043f\u0440\u043e\u0435\u043a\u0442\u0430. \u0415\u0433\u043e \u043f\u0435\u0440\u0432\u043e\u043d\u0430\u0447\u0430\u043b\u044c\u043d\u043e\u0435 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0442\u0430\u043a\u0438\u043c:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">site_name: \u041b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u043d\u043e\u0435 \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e \u0411\u0435\u043b\u044f\u043a\u043e\u0432\u043e\u0439 \u0410\u043d\u0430\u0441\u0442\u0430\u0441\u0438\u0438 nav:   - index.md<\/code><\/pre>\n<p>  <\/p>\n<p>\u042d\u0442\u043e\u0433\u043e \u0443\u0436\u0435 \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e, \u0447\u0442\u043e\u0431\u044b \u0441\u043e\u0431\u0440\u0430\u0442\u044c \u043c\u0438\u043d\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 \u0441\u0430\u0439\u0442. \u041d\u043e, \u043f\u0435\u0440\u0435\u0434 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u043e\u043c \u043a \u0441\u0431\u043e\u0440\u043a\u0435, \u044f \u0431\u044b \u0445\u043e\u0442\u0435\u043b \u0440\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0435\u0449\u0435 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u0435\u0434\u0432\u0430\u0440\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0445 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u0439.<\/p>\n<p>  <\/p>\n<h2 id=\"podklyuchenie-temy-oformleniya-material\">\u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435 \u0442\u0435\u043c\u044b \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044f Material<\/h2>\n<p>  <\/p>\n<p>\u041d\u0443\u0436\u043d\u0430\u044f \u043d\u0430\u043c \u0442\u0435\u043c\u0430 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u0442\u0430\u043a:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">theme:   name: material<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"rusifikaciya\">\u0420\u0443\u0441\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f<\/h2>\n<p>  <\/p>\n<p>\u0412 \u0448\u0430\u0431\u043b\u043e\u043d\u0435 \u0441\u0430\u0439\u0442\u0430 \u0438\u043c\u0435\u0435\u0442\u0441\u044f \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u043e\u043a\u0430\u043b\u0438\u0437\u0443\u0435\u043c\u044b\u0445 \u0441\u0442\u0440\u043e\u0447\u0435\u043a, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 &#171;search&#187;, &#171;previous&#187;, &#171;next&#187;. \u0418\u0445 \u043c\u043e\u0436\u043d\u043e \u043f\u0435\u0440\u0435\u0432\u0435\u0441\u0442\u0438 \u043d\u0430 \u0440\u0443\u0441\u0441\u043a\u0438\u0439, \u0434\u043e\u0431\u0430\u0432\u0438\u0432 \u043f\u043b\u0430\u0433\u0438\u043d <code>i18n<\/code> (internationalization) c \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u043c \u044f\u0437\u044b\u043a\u043e\u043c <code>ru<\/code>.<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">plugins:   - i18n:       docs_structure: suffix       default_language: ru       languages:         ru:           name: Russian           build: true           site_name: \"\u041b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u043d\u043e\u0435 \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e \u0411\u0435\u043b\u044f\u043a\u043e\u0432\u043e\u0439 \u0410\u043d\u0430\u0441\u0442\u0430\u0441\u0438\u0438\"<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"vstroennyy-poisk\">\u0412\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u0439 \u043f\u043e\u0438\u0441\u043a<\/h2>\n<p>  <\/p>\n<p>\u041d\u0430 \u0441\u0430\u0439\u0442 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043f\u043e\u0438\u0441\u043a:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">plugins:   - search<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"nastroyka-lokalnoy-sborki-sayta-v-docker\">\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e\u0439 \u0441\u0431\u043e\u0440\u043a\u0438 \u0441\u0430\u0439\u0442\u0430 \u0432 Docker<\/h2>\n<p>  <\/p>\n<p>\u041f\u043e\u0440\u0430 \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0447\u0442\u043e \u043f\u043e\u043b\u0443\u0447\u0438\u043b\u043e\u0441\u044c. \u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u0437\u0430\u0441\u043e\u0440\u044f\u0442\u044c \u043d\u043e\u0443\u0442\u0431\u0443\u043a \u0440\u0435\u0431\u0435\u043d\u043a\u0430 MkDocs-\u043e\u043c, \u041f\u0438\u0442\u043e\u043d\u043e\u043c, \u0438 \u043f\u0440\u043e\u0447\u0438\u043c\u0438 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u044f\u043c\u0438, <del>\u0437\u0430\u0441\u043e\u0440\u0438\u043c \u0435\u0433\u043e Docker&#8217;\u043e\u043c<\/del> \u0432\u043e\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u0441\u044f Docker&#8217;\u043e\u043c (\u043f\u0443\u0441\u0442\u044c \u0437\u0430\u043e\u0434\u043d\u043e \u0447\u0443\u0442\u044c-\u0447\u0443\u0442\u044c \u0441 \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0438\u0437\u0430\u0446\u0438\u0435\u0439 \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u0441\u044f). \u041f\u0438\u0448\u0435\u043c \u0442\u0430\u043a\u043e\u0439 \u043d\u0435\u0445\u0438\u0442\u0440\u044b\u0439 <code>Containerfile<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">FROM docker.io\/library\/python:alpine WORKDIR \/tmp COPY .\/requirements.txt . RUN apk add --update --no-cache --virtual .build-deps gcc musl-dev &amp;&amp;\\     apk add --no-cache git ca-certificates curl &amp;&amp;\\     pip install --no-cache-dir --requirement .\/requirements.txt &amp;&amp;\\     apk del .build-deps &amp;&amp;\\     rm .\/requirements.txt WORKDIR \/d CMD [\"mkdocs\", \"serve\", \"-a\", \"0.0.0.0:8000\"]<\/code><\/pre>\n<p>  <\/p>\n<p>\u0414\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u0441\u043f\u0438\u0441\u043e\u043a \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0435\u0439 \u0432 \u0444\u0430\u0439\u043b <code>requirements.txt<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">mkdocs>=1.2.1 mkdocs-material>=7.1.0 mkdocs-static-i18n<\/code><\/pre>\n<p>  <\/p>\n<p>\u0421\u043e\u0431\u0438\u0440\u0430\u0435\u043c \u043e\u0431\u0440\u0430\u0437:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">docker build -t lib-beliakova -f Containerfile .<\/code><\/pre>\n<p>  <\/p>\n<p>\u0417\u0430\u043f\u0443\u0441\u043a\u0430\u0435\u043c \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u0439 \u0432\u0435\u0431-\u0441\u0435\u0440\u0432\u0435\u0440 MkDocs:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">docker run --rm -itp 8000:8000 -v \"$(pwd):\/d\" lib-beliakova<\/code><\/pre>\n<p>  <\/p>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u043c\u043e\u0436\u043d\u043e \u0443\u0432\u0438\u0434\u0435\u0442\u044c \u043f\u043e\u043b\u0443\u0447\u0438\u0432\u0448\u0438\u0439\u0441\u044f \u0441\u0430\u0439\u0442\u0438\u043a \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 \u043f\u043e \u0441\u0441\u044b\u043b\u043a\u0435 <a href=\"https:\/\/lib-beliakova.github.io\/\" rel=\"nofollow noopener noreferrer\">http:\/\/localhost:8000\/<\/a>. \u0415\u0441\u043b\u0438 \u0438\u0437\u043c\u0435\u043d\u0438\u0442\u044c \u043b\u044e\u0431\u043e\u0439 \u0444\u0430\u0439\u043b \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\u0435 \u0438 \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0442\u044c\u0441\u044f, MkDocs \u043d\u0435\u043c\u0435\u0434\u043b\u0435\u043d\u043d\u043e \u043f\u043e\u0434\u0445\u0432\u0430\u0442\u0438\u0442 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f, \u043f\u0435\u0440\u0435\u0441\u043e\u0431\u0435\u0440\u0435\u0442 \u0441\u0430\u0439\u0442, \u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430 \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 \u0441\u0440\u0430\u0437\u0443 \u043e\u0431\u043d\u043e\u0432\u0438\u0442\u0441\u044f. \u041e\u0447\u0435\u043d\u044c \u0443\u0434\u043e\u0431\u043d\u043e \u2014 \u043c\u043e\u0436\u043d\u043e \u043f\u0440\u0430\u0432\u0438\u0442\u044c Markdown-\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b, \u0432\u0440\u0435\u043c\u044f \u043e\u0442 \u0432\u0440\u0435\u043c\u0435\u043d\u0438 \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0442\u044c\u0441\u044f, \u0438 \u0441\u0440\u0430\u0437\u0443 \u0432\u0438\u0434\u0435\u0442\u044c \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u0432 \u043e\u043a\u043d\u0435 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430.<\/p>\n<p>  <\/p>\n<h2 id=\"napolnenie-kontentom\">\u041d\u0430\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0435 \u043a\u043e\u043d\u0442\u0435\u043d\u0442\u043e\u043c<\/h2>\n<p>  <\/p>\n<p>\u0422\u0443\u0442 \u044f \u0443\u0436\u0435 \u0443\u0441\u0442\u0443\u043f\u0438\u043b \u043c\u0435\u0441\u0442\u043e \u0437\u0430 \u043a\u043b\u0430\u0432\u0438\u0430\u0442\u0443\u0440\u043e\u0439 \u044e\u043d\u043e\u0439 \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c\u043d\u0438\u0446\u0435, \u043f\u043e\u043a\u0430\u0437\u0430\u0432 \u0430\u0437\u044b Markdown \u2014 \u043a\u0430\u043a \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0438, \u0440\u0430\u0437\u0431\u0438\u0432\u0430\u0442\u044c \u0442\u0435\u043a\u0441\u0442 \u043d\u0430 \u043f\u0430\u0440\u0430\u0433\u0440\u0430\u0444\u044b \u0438 \u0432\u0441\u0442\u0430\u0432\u043b\u044f\u0442\u044c \u0446\u0438\u0442\u0430\u0442\u044b.<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\"># \u0418\u0432\u0430\u043d-\u0434\u0432\u043e\u0440\u043d\u0438\u043a \u0438 \u0446\u0430\u0440\u0435\u0432\u043d\u0430-\u043f\u0442\u0438\u0446\u0430  \u0412 \u043e\u0434\u043d\u043e\u043c \u0446\u0430\u0440\u0441\u0442\u0432\u0435 \u0431\u044b\u043b, \u043a\u0430\u043a \u043f\u043e\u043b\u043e\u0436\u0435\u043d\u043e, \u0446\u0430\u0440\u044c. \u041d\u0443 \u0438 \u043a\u043e\u043d\u0435\u0447\u043d\u043e \u0436\u0435, \u0443 \u044d\u0442\u043e\u0433\u043e \u0446\u0430\u0440\u044f \u0431\u044b\u043b\u0438 \u043f\u043e\u0434\u0434\u0430\u043d\u043d\u044b\u0435, \u043a\u0440\u0435\u0441\u0442\u044c\u044f\u043d\u0435, \u0437\u0435\u043c\u043b\u0435\u0434\u0435\u043b\u044c\u0446\u044b, \u0440\u0435\u043c\u0435\u0441\u043b\u0435\u043d\u043d\u0438\u043a\u0438.  \u0423 \u043e\u0434\u043d\u043e\u0433\u043e \u043a\u0440\u0435\u0441\u0442\u044c\u044f\u043d\u0438\u043d\u0430 \u0431\u044b\u043b\u043e \u0442\u0440\u0438 \u0441\u044b\u043d\u0430. \u0418 \u043c\u043b\u0430\u0434\u0448\u0435\u0433\u043e \u0437\u0432\u0430\u043b\u0438 \u0418\u0432\u0430\u043d\u043e\u043c.  \u0416\u0438\u043b\u0438 \u043e\u043d\u0438 \u0431\u0435\u0434\u043d\u043e, \u0441\u044b\u043d\u043e\u0432\u044c\u044f \u0432 \u0448\u043a\u043e\u043b\u0443 \u043d\u0435 \u0445\u043e\u0434\u0438\u043b\u0438 \u0438 \u0432 \u0438\u043d\u0441\u0442\u0438\u0442\u0443\u0442 \u0441 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0438\u0442\u0435\u0442\u043e\u043c \u0442\u043e\u0436\u0435.   \u0418 \u0432\u044b\u0440\u043e\u0441\u043b\u0438 \u0440\u0435\u0431\u044f\u0442\u0430 \u0432\u0437\u0440\u043e\u0441\u043b\u044b\u0435. \u0418 \u0437\u0430\u0434\u0443\u043c\u0430\u043b\u0441\u044f \u043c\u043b\u0430\u0434\u0448\u0438\u0439 \u0418\u0432\u0430\u043d, \u043a\u0435\u043c \u0435\u043c\u0443 \u0440\u0430\u0431\u043e\u0442\u0430\u0442\u044c.  \u0418\u0434\u0451\u0442 \u0418\u0432\u0430\u043d \u043f\u043e \u0443\u043b\u0438\u0446\u0435. \u0412\u0434\u0440\u0443\u0433 \u0441\u043c\u043e\u0442\u0440\u0438\u0442 -- \u043e\u0431\u044a\u044f\u0432\u043b\u0435\u043d\u0438\u0435.  > \u0421\u0440\u043e\u0447\u043d\u043e \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f \u0446\u0430\u0440\u0441\u043a\u0438\u0439 \u0434\u0432\u043e\u0440\u043d\u0438\u043a!  \u041f\u0440\u0438\u0448\u0451\u043b \u0418\u0432\u0430\u043d \u043a \u0446\u0430\u0440\u044e \u043d\u0430 \u0441\u043e\u0431\u0435\u0441\u0435\u0434\u043e\u0432\u0430\u043d\u0438\u0435, \u0441\u043f\u0440\u0430\u0448\u0438\u0432\u0430\u0435\u0442:  ...<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/tales\/Ivan-dvornik\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/tales\/Ivan-dvornik\/<\/a><\/p>\n<p>  <\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u043a\u0430\u0437\u0430\u043b \u043a\u043e\u043c\u0430\u043d\u0434\u0443 \u0437\u0430\u043f\u0443\u0441\u043a\u0430 MkDocs \u0432 Docker.<\/p>\n<p>  <\/p>\n<p>\u0414\u043e\u0447\u043a\u0430 \u0441\u043f\u0440\u0430\u0432\u0438\u043b\u0430\u0441\u044c \u0441 \u043f\u0435\u0440\u0435\u043f\u0435\u0447\u0430\u0442\u044b\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u0432\u043e\u0438\u0445 \u0431\u0443\u043c\u0430\u0436\u043d\u044b\u0445 \u0440\u0443\u043a\u043e\u043f\u0438\u0441\u0435\u0439 \u0432 markdown \u0431\u0435\u0437 \u043e\u0441\u043e\u0431\u044b\u0445 \u0437\u0430\u0442\u0440\u0443\u0434\u043d\u0435\u043d\u0438\u0439. \u041e\u043a\u0430\u0437\u0430\u043b\u043e\u0441\u044c, \u0447\u0442\u043e \u044d\u0442\u043e \u043d\u0435 \u0441\u043b\u043e\u0436\u043d\u0435\u0435 \u0440\u0430\u0431\u043e\u0442\u044b \u0441 Word \u043d\u0430 \u0448\u043a\u043e\u043b\u044c\u043d\u044b\u0445 \u0443\u0440\u043e\u043a\u0430\u0445 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0442\u0438\u043a\u0438. \u041d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c \u043f\u043e markdown-\u0444\u0430\u0439\u043b\u0438\u043a\u0443 \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0432 \u043f\u0440\u043e\u0435\u043a\u0442 \u0432 \u043f\u0430\u043f\u043a\u0443 <code>docs<\/code>, \u0438 \u043d\u0435 \u0437\u0430\u0431\u044b\u0432\u0430\u0442\u044c &#171;\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c&#187; \u043a\u0430\u0436\u0434\u044b\u0439 \u0444\u0432\u0439\u043b \u0432 <code>mkdoc.yaml<\/code> \u0432 \u0441\u0435\u043a\u0446\u0438\u0438 <code>nav<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">nav:   - index.md   - news.md   - \u0420\u0430\u0441\u0441\u043a\u0430\u0437\u044b:      - stories\/index.md      - stories\/summer.md      - stories\/under-our-house.md      - stories\/preparation-for-festival.md      - stories\/zastroyschiki.md     \/\/ ...   - \u0421\u043a\u0430\u0437\u043a\u0438:      - tales\/index.md      - tales\/Ivan-dvornik.md      - tales\/Masha-rasteryasha.md      - tales\/rainbow-lama.md   - \u0421\u043a\u0430\u0437\u043a\u0438:      - tales\/index.md      - tales\/Ivan-dvornik.md      - tales\/Masha-rasteryasha.md      - tales\/rainbow-lama.md   - \u0424\u0430\u043d\u0444\u0438\u043a\u0438:      - fanfics\/index.md      - fanfics\/stolen-sun.md      - fanfics\/smeshariki.md      \/\/ ...<\/code><\/pre>\n<p>  <\/p>\n<p>\u0422\u0443\u0442 \u043f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u044c \u044e\u043d\u0443\u044e \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c\u043d\u0438\u0446\u0443 \u0441 \u0430\u0437\u0430\u043c\u0438 YAML, \u0445\u043e\u0440\u043e\u0448\u043e \u0447\u0442\u043e VS Code \u043f\u043e\u0434\u0441\u0432\u0435\u0447\u0438\u0432\u0430\u0435\u0442 \u043e\u0448\u0438\u0431\u043a\u0438.<\/p>\n<p>  <\/p>\n<p>\u041d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0433\u043e \u043f\u0443\u043d\u043a\u0442\u0430 \u043c\u043e\u0436\u043d\u043e \u043d\u0435 \u043f\u0438\u0441\u0430\u0442\u044c, MkDocs \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0434\u043e\u0441\u0442\u0430\u0435\u0442 \u0438\u0445 \u0438\u0437 Markdown (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442 \u043f\u0435\u0440\u0432\u044b\u0439 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a). <\/p>\n<p>  <\/p>\n<p>\u0423 \u043d\u0430\u0441 &#171;\u0443\u0437\u043b\u044b&#187; \u043e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u0430\u0441\u0441\u043e\u0446\u0438\u0438\u0440\u0443\u044e\u0442\u0441\u044f \u0441 \u0438\u043d\u0434\u0435\u043a\u0441\u043d\u044b\u043c\u0438 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430\u043c\u0438 <code>index.md<\/code> \u2014 \u044d\u0442\u043e \u043a\u0430\u043a \u0431\u044b &#171;\u043b\u0435\u043d\u0434\u0438\u043d\u0433\u0438&#187;, \u0447\u0442\u043e\u0431\u044b \u043c\u043e\u0436\u043d\u043e \u0431\u044b\u043b\u043e \u0434\u0430\u0442\u044c \u043a\u043e\u043c\u0443-\u0442\u043e \u0441\u0441\u044b\u043b\u043a\u0443 \u043d\u0430 <a href=\"https:\/\/lib-beliakova.github.io\/stories\/\" rel=\"nofollow noopener noreferrer\">&#171;\u0432\u0441\u0435 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b&#187;<\/a>, <a href=\"https:\/\/lib-beliakova.github.io\/tales\/\" rel=\"nofollow noopener noreferrer\">&#171;\u0432\u0441\u0435 \u0441\u043a\u0430\u0437\u043a\u0438&#187;<\/a> \u0438\u043b\u0438 <a href=\"https:\/\/lib-beliakova.github.io\/fanfics\/\" rel=\"nofollow noopener noreferrer\">&#171;\u0432\u0441\u0435 \u0444\u0430\u043d\u0444\u0438\u043a\u0438&#187;<\/a>. \u041f\u043e-\u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e MkDocs Material \u0442\u0430\u043a \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442 (\u0443\u0437\u043b\u044b \u043e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u043f\u0440\u043e\u0441\u0442\u043e \u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f \u043a\u043e\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430\u043c\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432, \u043d\u0435 \u0438\u043c\u0435\u044f \u0441\u0432\u043e\u0435\u0433\u043e \u043a\u043e\u043d\u0442\u0435\u043d\u0442\u0430). \u0427\u0442\u043e\u0431\u044b \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043d\u0443\u0436\u043d\u043e\u0435 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u0435, \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 \u043a\u043e\u043d\u0444\u0438\u0433 \u043f\u0430\u0440\u043c\u0435\u0442\u0440 <code>navigation.indexes<\/code>: <\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">theme:     name: material     features:       - navigation.indexes<\/code><\/pre>\n<p>  <\/p>\n<p>\u041f\u0440\u0438 \u0436\u0435\u043b\u0430\u043d\u0438\u0438, \u043c\u043e\u0436\u043d\u043e \u0435\u0449\u0435 \u0432\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u043e\u043f\u0446\u0438\u044e <code>navigation.expand<\/code> (\u0440\u044f\u0434\u043e\u043c \u0441 <code>navigation.indexes<\/code>) \u2014 \u0432 \u044d\u0442\u043e\u043c \u0441\u043b\u0443\u0447\u0430\u0435 \u043e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u0431\u0443\u0434\u0435\u0442 \u0441\u0440\u0430\u0437\u0443 \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u0442\u044c\u0441\u044f \u0432 \u0440\u0430\u0437\u0432\u0435\u0440\u043d\u0443\u0442\u043e\u043c \u0432\u0438\u0434\u0435. <\/p>\n<p>  <\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f, \u043e\u0442\u043b\u0438\u0447\u043d\u044b\u0435 \u043e\u0442 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u043e\u0432 \u0432\u043d\u0443\u0442\u0440\u0438 \u0444\u0430\u0439\u043b\u043e\u0432. \u041d\u0430\u043c \u044d\u0442\u043e \u043d\u0435 \u043f\u043e\u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043b\u043e\u0441\u044c, \u043d\u043e \u0432\u043e\u0442 \u043f\u0440\u0438\u043c\u0435\u0440 \u0438\u0437 <a href=\"https:\/\/squidfunk.github.io\/mkdocs-material\/setup\/setting-up-navigation\/?h=nav#section-index-pages\" rel=\"nofollow noopener noreferrer\">\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 MkDocs Material<\/a>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">nav:   - Section:     - section\/index.md      - Page 1: section\/page-1.md     ...     - Page n: section\/page-n.md<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"publikaciya-v-github-pages-s-ispolzovaniem-github-actions\">\u041f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u044f \u0432 GitHub Pages \u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c GitHub Actions<\/h2>\n<p>  <\/p>\n<p>\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u043c git-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439, \u0434\u0435\u043b\u0430\u0435\u043c \u043f\u0435\u0440\u0432\u044b\u0439 commit, \u0437\u0430\u043a\u0438\u0434\u044b\u0432\u0430\u0435\u043c \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u043d\u0430 GitHub \u0438 <a href=\"https:\/\/pages.github.com\/\" rel=\"nofollow noopener noreferrer\">\u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c GitHub Pages<\/a> (\u0442\u0443\u0442 \u043d\u0435 \u0431\u0443\u0434\u0443 \u0432\u0434\u0430\u0432\u0430\u0442\u044c\u0441\u044f \u0432 \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438, \u0432\u0441\u0435 \u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u043e).<\/p>\n<p>  <\/p>\n<p>\u0414\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u0444\u0430\u0439\u043b\u0438\u043a <code>.github\/workflows \/mkdocs.yml<\/code> \u0441 \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u044f\u043c\u0438 \u043f\u043e \u0441\u0431\u043e\u0440\u043a\u0435 \u0438 \u0434\u0435\u043f\u043b\u043e\u044e \u0441\u0430\u0439\u0442\u0430 \u0434\u043b\u044f GitHub Actions:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">name: mkdocs on:   push:     branches:       - main jobs:   deploy:     runs-on: ubuntu-latest     steps:       - uses: actions\/checkout@v2       - uses: actions\/setup-python@v2         with:           python-version: 3.x       - run: pip install mkdocs-material mkdocs-static-i18n       - run: mkdocs gh-deploy --force<\/code><\/pre>\n<p>  <\/p>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u044e\u043d\u0430\u044f \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c\u043d\u0438\u0446\u0430 \u043c\u043e\u0436\u0435\u0442 \u0434\u0435\u043b\u0430\u0442\u044c commit \u0438 push \u0432 VS Code, \u0438 \u0447\u0435\u0440\u0435\u0437 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043c\u0438\u043d\u0443\u0442 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043f\u043e\u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f \u043d\u0430 \u0441\u0430\u0439\u0442\u0435.<\/p>\n<p>  <\/p>\n<p>\u0415\u0441\u043b\u0438 \u0441\u043a\u0443\u0447\u043d\u043e \u0436\u0434\u0430\u0442\u044c, \u043c\u043e\u0436\u043d\u043e \u0441\u043b\u0435\u0434\u0438\u0442\u044c \u0437\u0430 \u043f\u0440\u043e\u0446\u0435\u0441\u0441\u043e\u043c \u0432 \u0440\u0430\u0437\u0434\u0435\u043b\u0435 <strong>Actions<\/strong> \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u043d\u0430 GitHub.<\/p>\n<p>  <\/p>\n<h2 id=\"google-analytics\">Google Analytics<\/h2>\n<p>  <\/p>\n<p>\u041f\u0435\u0440\u0432\u044b\u0435 \u0432\u043e\u043f\u0440\u043e\u0441\u044b \u0434\u043e\u0447\u043a\u0438 \u043f\u043e\u0441\u043b\u0435 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0441\u0430\u0439\u0442\u0430 \u2014 \u0441\u043c\u043e\u0442\u0440\u0438\u0442 \u043b\u0438 \u043a\u0442\u043e-\u0442\u043e \u0435\u0451 \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e? \u0421\u043a\u043e\u043b\u044c\u043a\u043e \u043b\u044e\u0434\u0435\u0439 \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u043b\u043e? \u041a \u0441\u0447\u0430\u0441\u0442\u044c\u044e, \u0432 MkDocs \u0435\u0441\u0442\u044c \u0432\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u0430\u044f \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 GA, \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0441\u0447\u0435\u0442\u0447\u0438\u043a \u043d\u0430 \u0441\u0430\u0439\u0442 \u043c\u043e\u0436\u043d\u043e \u043f\u0430\u0440\u043e\u0439 \u0441\u0442\u0440\u043e\u0447\u0435\u043a \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">extra:     analytics:         provider: google         property: G-9ZRQD3E6FD<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0430\u0437\u0443\u043c\u0435\u0435\u0442\u0441\u044f, \u043d\u0430\u0434\u043e \u0441\u043f\u0435\u0440\u0432\u0430 \u0437\u0430\u0440\u0435\u0433\u0438\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c &#171;property&#187; \u043d\u0430 <a href=\"https:\/\/analytics.google.com\/\" rel=\"nofollow noopener noreferrer\">https:\/\/analytics.google.com\/<\/a> \u0438 \u043f\u043e\u0434\u0442\u0432\u0435\u0440\u0434\u0438\u0442\u044c &#171;\u043f\u0440\u0430\u0432\u0430 \u0432\u043b\u0430\u0434\u0435\u043d\u0438\u044f&#187; \u0441\u0430\u0439\u0442\u043e\u043c. \u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0435\u0441\u0442\u044c \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u043e\u0432, \u0441\u0430\u043c\u044b\u043c \u043f\u0440\u043e\u0441\u0442\u044b\u043c \u043c\u043d\u0435 \u043f\u043e\u043a\u0430\u0437\u0430\u043b\u043e\u0441\u044c \u0437\u0430\u043a\u0438\u043d\u0443\u0442\u044c \u0441\u0433\u0435\u043d\u0435\u0440\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u0413\u0443\u0433\u043b\u043e\u043c \u0444\u0430\u0439\u043b\u0438\u043a \u0432 \u043a\u043e\u0440\u0435\u043d\u044c \u0441\u0430\u0439\u0442\u0430. \u041d\u0438\u043a\u0430\u043a\u0438\u0435 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 &#171;\u043f\u0440\u0438\u0441\u0435\u0434\u0430\u043d\u0438\u044f&#187; \u0434\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u043d\u0435 \u043d\u0443\u0436\u043d\u044b. \u0414\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u043f\u043e\u043b\u043e\u0436\u0438\u0442\u044c \u0444\u0430\u0439\u043b \u0432 \u043f\u0430\u043f\u043a\u0443 <code>docs<\/code> \u0438 \u043e\u043d \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043e\u043a\u0430\u0436\u0435\u0442\u0441\u044f \u0432 \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u043f\u0430\u043f\u043a\u0435 \u0441\u0430\u0439\u0442\u0430.<\/p>\n<p>  <\/p>\n<p>\u0427\u0435\u0440\u0435\u0437 \u0434\u0435\u043d\u044c-\u0434\u0440\u0443\u0433\u043e\u0439 \u0432 Google Analytics \u0443\u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u0431\u0443\u0434\u0435\u0442 \u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u043e\u0442\u0447\u0435\u0442\u044b.<\/p>\n<p>  <\/p>\n<h2 id=\"forma-obratnoy-svyazi\">\u0424\u043e\u0440\u043c\u0430 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u0432\u044f\u0437\u0438<\/h2>\n<p>  <\/p>\n<p>\u041e\u0436\u0438\u0434\u0430\u0435\u043c\u043e, \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u0432\u043e\u043f\u0440\u043e\u0441 \u044e\u043d\u043e\u0439 \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c\u043d\u0438\u0446\u044b \u2014 \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u043b\u0438 \u043a\u043e\u043c\u0443-\u0442\u043e \u0435\u0451 \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e? \u0412\u0434\u0440\u0443\u0433 \u043d\u0435 \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f? \u0421\u0431\u043e\u0440 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0439 \u0441\u0432\u044f\u0437\u0438 \u043c\u043e\u0436\u043d\u043e \u043b\u0435\u0433\u043a\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u043e\u0432\u0430\u0442\u044c \u0447\u0435\u0440\u0435\u0437 \u0442\u0443 \u0436\u0435 Google Analytics:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">extra:     analytics:         provider: google         property: G-9ZRQD3E6FD         feedback:           title: \u0412\u0430\u043c \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u044d\u0442\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430?           ratings:             - icon: material\/thumb-up-outline               name: \u0414\u0430               data: 1               note: \u0421\u043f\u0430\u0441\u0438\u0431\u043e! \u042f \u0440\u0430\u0434\u0430, \u0447\u0442\u043e \u0432\u0430\u043c \u043f\u043e\u043d\u0440\u0430\u0432\u0438\u043b\u043e\u0441\u044c.             - icon: material\/thumb-down-outline               name: \u041d\u0435\u0442               data: 0               note: \u0416\u0430\u043b\u044c, \u0447\u0442\u043e \u0432\u0430\u043c \u043d\u0435 \u043f\u043e\u043d\u0440\u0430\u0432\u0438\u043b\u043e\u0441\u044c...<\/code><\/pre>\n<p>  <\/p>\n<p>\u0412 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0435, \u0432\u043d\u0438\u0437\u0443 \u043a\u0430\u0436\u0434\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u0438\u0447\u043a\u0438 \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0442\u0430\u043a\u0430\u044f \u0440\u0430\u0437\u043c\u0435\u0442\u043a\u0430:<\/p>\n<p>  <\/p>\n<pre><code class=\"html\">&lt;form class=\"md-feedback\" name=\"feedback\">     &lt;fieldset>       &lt;legend class=\"md-feedback__title\">         \u0412\u0430\u043c \u043d\u0440\u0430\u0432\u0438\u0442\u0441\u044f \u044d\u0442\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430?       &lt;\/legend>       &lt;div class=\"md-feedback__inner\">         &lt;div class=\"md-feedback__list\">             &lt;button class=\"md-feedback__icon md-icon\" type=\"submit\" title=\"\u0414\u0430\" data-md-value=\"1\">               &lt;svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 24 24\">&lt;path d=\"M5 9v12H1V9h4m4 12a2 2 0 0 1-2-2V9c0-.55.22-1.05.59-1.41L14.17 1l1.06 1.06c.27.27.44.64.44 1.05l-.03.32L14.69 8H21a2 2 0 0 1 2 2v2c0 .26-.05.5-.14.73l-3.02 7.05C19.54 20.5 18.83 21 18 21H9m0-2h9.03L21 12v-2h-8.79l1.13-5.32L9 9.03V19Z\">&lt;\/path>&lt;\/svg>             &lt;\/button>                 &lt;button class=\"md-feedback__icon md-icon\" type=\"submit\" title=\"\u041d\u0435\u0442\" data-md-value=\"0\">               &lt;svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" viewBox=\"0 0 24 24\">&lt;path d=\"M19 15V3h4v12h-4M15 3a2 2 0 0 1 2 2v10c0 .55-.22 1.05-.59 1.41L9.83 23l-1.06-1.06c-.27-.27-.44-.64-.44-1.06l.03-.31.95-4.57H3a2 2 0 0 1-2-2v-2c0-.26.05-.5.14-.73l3.02-7.05C4.46 3.5 5.17 3 6 3h9m0 2H5.97L3 12v2h8.78l-1.13 5.32L15 14.97V5Z\">&lt;\/path>&lt;\/svg>             &lt;\/button>         &lt;\/div>         &lt;div class=\"md-feedback__note\">             &lt;div data-md-value=\"1\" hidden=\"\">                \u0421\u043f\u0430\u0441\u0438\u0431\u043e! \u042f \u0440\u0430\u0434\u0430, \u0447\u0442\u043e \u0432\u0430\u043c \u043f\u043e\u043d\u0440\u0430\u0432\u0438\u043b\u043e\u0441\u044c.             &lt;\/div>             &lt;div data-md-value=\"0\" hidden=\"\">                \u0416\u0430\u043b\u044c, \u0447\u0442\u043e \u0432\u0430\u043c \u043d\u0435 \u043f\u043e\u043d\u0440\u0430\u0432\u0438\u043b\u043e\u0441\u044c...             &lt;\/div>           &lt;\/div>       &lt;\/div>     &lt;\/fieldset>   &lt;\/form> <\/code><\/pre>\n<p>  <\/p>\n<p>\u0412 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 \u044d\u0442\u043e \u0432\u044b\u0433\u043b\u044f\u0434\u0438\u0442 \u0438 \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0442\u0430\u043a:<\/p>\n<p>  <\/p>\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/103\/0a1\/038\/1030a1038dcca3db9554c1af381edcb2.gif\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/103\/0a1\/038\/1030a1038dcca3db9554c1af381edcb2.gif\"\/><\/p>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u043c\u043e\u0436\u043d\u043e \u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c \u0432 GA, \u0435\u0441\u043b\u0438 \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043e\u0442\u0447\u0435\u0442 \u043f\u043e \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438. \u0418\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u044f \u043d\u0430\u0434\u0435\u0436\u043d\u043e \u0441\u043f\u0440\u044f\u0442\u0430\u043d\u0430 <a href=\"https:\/\/squidfunk.github.io\/mkdocs-material\/setup\/setting-up-site-analytics\/?h=fee#was-this-page-helpful\" rel=\"nofollow noopener noreferrer\">\u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 MkDocs<\/a> \u043f\u043e\u0434 \u0441\u043f\u043e\u0439\u043b\u0435\u0440\u043e\u043c <strong>How to visualize the collected feedback ratings<\/strong> \ud83d\ude42<\/p>\n<p>  <\/p>\n<h2 id=\"yandeks-metrika\">\u042f\u043d\u0434\u0435\u043a\u0441 \u041c\u0435\u0442\u0440\u0438\u043a\u0430<\/h2>\n<p>  <\/p>\n<p>\u0423 \u0432\u0435\u0431-\u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0438 \u043e\u0442 \u042f\u043d\u0434\u0435\u043a\u0441\u0430 \u0435\u0441\u0442\u044c \u0437\u0430\u043c\u0435\u0447\u0430\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0448\u0442\u0443\u043a\u0430, \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u044e\u0449\u0430\u044f \u043f\u043e\u0434\u0441\u043c\u0430\u0442\u0440\u0438\u0432\u0430\u0442\u044c \u0437\u0430 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f\u043c\u0438 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0445 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 \u2014 <a href=\"https:\/\/yandex.ru\/support\/metrica\/webvisor\/about-webvisor.html\" rel=\"nofollow noopener noreferrer\">\u0412\u0435\u0431\u0432\u0438\u0437\u043e\u0440<\/a>. \u041f\u043e\u044d\u0442\u043e\u043c\u0443, \u0437\u0430\u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0442\u0430\u043a\u0436\u0435 \u0438 \u0441\u0447\u0435\u0442\u0447\u0438\u043a \u043e\u0442 \u042f\u043d\u0434\u0435\u043a\u0441\u0430 \u043d\u0430 \u0441\u0430\u0439\u0442. \u0418\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e \u0436\u0435 \u043f\u043e\u0441\u043c\u043e\u0442\u0440\u0435\u0442\u044c, \u043a\u0430\u043a \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u0438 \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0443\u044e\u0442 \u0441 \u0442\u0435\u043a\u0441\u0442\u043e\u043c, \u043a\u0430\u043a \u0441\u043a\u0440\u043e\u043b\u043b\u044f\u0442, \u043d\u0430 \u0447\u0435\u043c \u0437\u0430\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u044e\u0442 \u0432\u043d\u0438\u043c\u0430\u043d\u0438\u0435&#8230;<\/p>\n<p>  <\/p>\n<p>MkDocs \u043d\u0435 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u0430\u043d\u0430\u043b\u0438\u0442\u0438\u043a\u0443 \u043e\u0442 \u042f\u043d\u0434\u0435\u043a\u0441\u0430 \u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e. \u041d\u043e \u044d\u0442\u043e \u0437\u043d\u0430\u0447\u0438\u0442 \u043b\u0438\u0448\u044c \u0442\u043e, \u0447\u0442\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u042f\u043d\u0434\u0435\u043a\u0441\u0430 \u043f\u043e\u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u043b\u0438\u0448\u044c \u0447\u0443\u0442\u044c \u0431\u043e\u043b\u044c\u0448\u0435 \u0442\u0435\u043b\u043e\u0434\u0432\u0438\u0436\u0435\u043d\u0438\u0439 \u043f\u043e \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044e \u0441 Google.<\/p>\n<p>  <\/p>\n<p>\u041d\u0430\u0434\u043e \u043b\u0438\u0448\u044c \u0441\u043e\u0437\u0434\u0430\u0442\u044c \u0444\u0430\u0439\u043b <code>overrides\/main.html<\/code> \u0438 \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 \u043d\u0435\u0433\u043e \u043a\u043e\u0434 \u0441\u0447\u0435\u0442\u0447\u0438\u043a\u0430, \u0432\u044b\u0434\u0430\u043d\u043d\u044b\u0439 \u042f\u043d\u0434\u0435\u043a\u0441\u043e\u043c:<\/p>\n<p>  <\/p>\n<pre><code class=\"html\">{% extends \"base.html\" %}  {% block analytics %}     {{ super() }}     &lt;!-- Yandex.Metrika counter - \u0432\u0441\u0442\u0430\u0432\u0438\u0442\u044c \u0441\u044e\u0434\u0430 --> {% endblock %}<\/code><\/pre>\n<p>  <\/p>\n<p>\u0418 \u0437\u0430\u0442\u0435\u043c \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043f\u0430\u043f\u043a\u0443 \u0441 &#171;\u043e\u0432\u0435\u0440\u0440\u0430\u0439\u0434\u0430\u043c\u0438&#187; \u0442\u0435\u043c\u044b <code>material<\/code> \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 <code>mkdocs.yaml<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">theme:     name: material     custom_dir: overrides<\/code><\/pre>\n<p>  <\/p>\n<p>\u0412 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0435, \u0441\u0447\u0435\u0442\u0447\u0438\u043a \u042f\u043d\u0434\u0435\u043a\u0441\u0430 \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435 \u0441\u0440\u0430\u0437\u0443 \u043f\u043e\u0441\u043b\u0435 \u043a\u043e\u0434\u0430 \u0441\u0447\u0435\u0442\u0447\u0438\u043a\u0430 Google (\u0434\u043e\u0431\u0430\u0432\u043b\u0435\u043d\u043d\u043e\u0433\u043e \u0440\u0430\u043d\u0435\u0435 \u043f\u043e-\u043f\u0440\u043e\u0441\u0442\u043e\u043c\u0443).<\/p>\n<p>  <\/p>\n<h2 id=\"socialnye-knopki\">\u0421\u043e\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0435 \u043a\u043d\u043e\u043f\u043a\u0438<\/h2>\n<p>  <\/p>\n<p>\u0418\u0445 \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0442\u0430\u043a:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">extra:     social:     - icon: fontawesome\/brands\/telegram        link: https:\/\/t.me\/lib_beliakova       name: \u041a\u0430\u043d\u0430\u043b \u0432 Telegram     - icon: fontawesome\/brands\/youtube        link: https:\/\/www.youtube.com\/@a-tunes       name: \u041a\u0430\u043d\u0430\u043b \u043d\u0430 YouTube<\/code><\/pre>\n<p>  <\/p>\n<p>\u041a\u043d\u043e\u043f\u043a\u0438 \u043e\u0442\u043e\u0431\u0440\u0430\u0436\u0430\u044e\u0442\u0441\u044f \u0432 \u0444\u0443\u0442\u0435\u0440\u0435 \u0441\u0430\u0439\u0442\u0430 \u043d\u0430 \u043a\u0430\u0436\u0434\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435.<\/p>\n<p>  <\/p>\n<h2 id=\"admonition-bloki-note-warning-info-etc\">Admonition-\u0431\u043b\u043e\u043a\u0438 (note, warning, info, etc&#8230;)<\/h2>\n<p>  <\/p>\n<p>\u041c\u044b \u043f\u0440\u0438\u0434\u0443\u043c\u0430\u043b\u0438 \u0440\u0435\u043f\u043e\u0441\u0442\u0438\u0442\u044c \u043d\u043e\u0432\u043e\u0441\u0442\u0438 \u0441 \u0441\u0430\u0439\u0442\u0430 \u0432 \u043a\u0430\u043d\u0430\u043b\u0435 Telegram \u043a\u0430\u043d\u0430\u043b, \u0447\u0442\u043e\u0431\u044b \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u044f\u043c \u0431\u044b\u043b\u043e \u043d\u0430 \u0447\u0442\u043e \u043f\u043e\u0434\u043f\u0438\u0441\u0430\u0442\u044c\u0441\u044f. \u0410 \u0447\u0442\u043e\u0431\u044b \u0434\u043e\u043d\u0435\u0441\u0442\u0438 \u044d\u0442\u043e \u0434\u043e \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u0435\u0439, \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438 \u0432\u0432\u0435\u0440\u0445\u0443 \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435 \u043d\u043e\u0432\u043e\u0441\u0442\u0435\u0439 \u0437\u0430\u043c\u0435\u0442\u043d\u0443\u044e \u0441\u0441\u044b\u043b\u043a\u0443 \u0432 admonition-\u0431\u043b\u043e\u043a\u0435:<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\"># \u041d\u043e\u0432\u043e\u0441\u0442\u0438  !!! info \"\u041d\u043e\u0432\u043e\u0441\u0442\u0438 \u0432 Telegram\"     \u0427\u0442\u043e\u0431\u044b \u043d\u0435 \u043f\u0440\u043e\u043f\u0443\u0441\u043a\u0430\u0442\u044c \u043d\u043e\u0432\u043e\u0441\u0442\u0438, \u043f\u043e\u0434\u043f\u0438\u0448\u0438\u0442\u0435\u0441\u044c \u043d\u0430 [\u043a\u0430\u043d\u0430\u043b \u0441\u0430\u0439\u0442\u0430 \u0432 Telegram :fontawesome-brands-telegram:](https:\/\/t.me\/lib_beliakova).  ## 22.02.2023: \u0418\u0437\u0434\u0430\u043d \u0441\u0431\u043e\u0440\u043d\u0438\u043a \u043c\u043e\u0438\u0445 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u0439 ... <\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/news\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/news\/<\/a><\/p>\n<p>  <\/p>\n<p>\u041f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430 admonitions \u0432\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u0432 <code>mkdocs.yaml<\/code> Markdown-\u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435\u043c <a href=\"https:\/\/squidfunk.github.io\/mkdocs-material\/reference\/admonitions\/\" rel=\"nofollow noopener noreferrer\">admonition<\/a>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">markdown_extensions:   - admonition<\/code><\/pre>\n<p>  <\/p>\n<p>\u0422\u0430\u043a\u0438\u0435 \u0431\u043b\u043e\u043a\u0438 \u0442\u0430\u043a\u0436\u0435 \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0432 \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0446\u0435\u043b\u044f\u0445. \u0415\u0441\u043b\u0438 \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u043f\u0443\u0441\u0442\u043e\u0439 caption \u0431\u043b\u043e\u043a\u0430, \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u043c \u043f\u0440\u043e\u0441\u0442\u043e \u0440\u0430\u0437\u043d\u043e\u0446\u0432\u0435\u0442\u043d\u044b\u0435 \u0440\u0430\u043c\u043e\u0447\u043a\u0438.<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\">\u041f\u0451\u0441\u0442\u0440\u0430\u044f \u0438 \u0448\u0443\u043c\u043d\u0430\u044f \u0442\u043e\u043b\u043f\u0430 \u043e\u043a\u0440\u0443\u0436\u0438\u043b\u0430 \u0446\u0430\u0440\u0435\u0432\u043d\u0443. \u0421\u043e \u0432\u0441\u0435\u0445 \u0441\u0442\u043e\u0440\u043e\u043d \u0441\u0432\u0435\u0442\u0438\u043b\u0438\u0441\u044c \u0438 \u043c\u0438\u0433\u0430\u043b\u0438 \u0441\u0432\u0435\u0442\u043e\u0434\u0438\u043e\u0434\u0430\u043c\u0438 \u0432\u044b\u0432\u0435\u0441\u043a\u0438, \u043e\u0434\u043d\u0430 \u0437\u0430\u0437\u044b\u0432\u0430\u044e\u0449\u0430\u044f \u0440\u0435\u043a\u043b\u0430\u043c\u0430 \u043f\u044b\u0442\u0430\u043b\u0430\u0441\u044c \u043f\u0435\u0440\u0435\u043a\u0440\u0438\u0447\u0430\u0442\u044c \u0434\u0440\u0443\u0433\u0443\u044e.  !!! note \"\"     \u041b\u0451\u0442\u043d\u044b\u0439 \u043a\u043b\u0443\u0431 \"\u0412\u043e\u043b\u0448\u0435\u0431\u043d\u044b\u0439 \u043c\u0438\u0440\": \u043e\u0442\u043a\u0440\u043e\u0439\u0442\u0435 \u043c\u0438\u0440 \u0441 \u0432\u044b\u0441\u043e\u0442\u044b \u043f\u043e\u043b\u0451\u0442\u0430 \u043a\u043e\u0432\u0440\u0430!  !!! info \"\"     \u0410\u043f\u0442\u0435\u043a\u0430 \u041a\u043e\u0449\u0435\u044f \u0411\u0435\u0441\u0441\u043c\u0435\u0440\u0442\u043d\u043e\u0433\u043e: \u044d\u043b\u0438\u043a\u0441\u0438\u0440 \u043c\u043e\u043b\u043e\u0434\u043e\u0441\u0442\u0438 \u043f\u043e \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e\u0439 \u0446\u0435\u043d\u0435 \u043e\u0442 \u043e\u0442\u0435\u0447\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0433\u043e \u0442\u043e\u0432\u0430\u0440\u043e\u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u044f!  !!! warning \"\"     \u041a\u0430\u0444\u0435 \"\u0421\u043a\u0430\u0442\u0435\u0440\u0442\u044c-\u0421\u0430\u043c\u043e\u0431\u0440\u0430\u043d\u043a\u0430\". \u0411\u043b\u044e\u0434\u043e \u0434\u043d\u044f: \u043a\u0430\u0448\u0430 \u0438\u0437 \u0442\u043e\u043f\u043e\u0440\u0430!  !!! tip \"\"     \u0413\u043e\u0441\u0442\u0438\u043d\u0438\u0446\u0430 \"\u0418\u0437\u0431\u0443\u0448\u043a\u0430 \u043d\u0430 \u043a\u0443\u0440\u044c\u0438\u0445 \u043d\u043e\u0436\u043a\u0430\u0445\": \u043d\u0430\u043a\u043e\u0440\u043c\u0438\u043c, \u043d\u0430\u043f\u043e\u0438\u043c \u0438 \u0441\u043f\u0430\u0442\u044c \u0443\u043b\u043e\u0436\u0438\u043c!  !!! example \"\"     \u0410\u0433\u0440\u043e\u043a\u043e\u043c\u043f\u043b\u0435\u043a\u0441 \"\u0423 \u0434\u0435\u0434\u043a\u0438\". \u041d\u0430\u0448\u0430 \u0440\u0435\u043f\u043a\u0430 \u0431\u043e\u043b\u044c\u0448\u0430\u044f-\u043f\u0440\u0435\u0431\u043e\u043b\u044c\u0448\u0430\u044f! <\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/tales\/Masha-rasteryasha\/#:~:text=%D0%9F%D1%91%D1%81%D1%82%D1%80%D0%B0%D1%8F%20%D0%B8%20%D1%88%D1%83%D0%BC%D0%BD%D0%B0%D1%8F%20%D1%82%D0%BE%D0%BB%D0%BF%D0%B0%20%D0%BE%D0%BA%D1%80%D1%83%D0%B6%D0%B8%D0%BB%D0%B0%20%D1%86%D0%B0%D1%80%D0%B5%D0%B2%D0%BD%D1%83.%20%D0%A1%D0%BE%20%D0%B2%D1%81%D0%B5%D1%85%20%D1%81%D1%82%D0%BE%D1%80%D0%BE%D0%BD%20%D1%81%D0%B2%D0%B5%D1%82%D0%B8%D0%BB%D0%B8%D1%81%D1%8C%20%D0%B8%20%D0%BC%D0%B8%D0%B3%D0%B0%D0%BB%D0%B8%20%D1%81%D0%B2%D0%B5%D1%82%D0%BE%D0%B4%D0%B8%D0%BE%D0%B4%D0%B0%D0%BC%D0%B8%20%D0%B2%D1%8B%D0%B2%D0%B5%D1%81%D0%BA%D0%B8%2C%20%D0%BE%D0%B4%D0%BD%D0%B0%20%D0%B7%D0%B0%D0%B7%D1%8B%D0%B2%D0%B0%D1%8E%D1%89%D0%B0%D1%8F%20%D1%80%D0%B5%D0%BA%D0%BB%D0%B0%D0%BC%D0%B0%20%D0%BF%D1%8B%D1%82%D0%B0%D0%BB%D0%B0%D1%81%D1%8C%20%D0%BF%D0%B5%D1%80%D0%B5%D0%BA%D1%80%D0%B8%D1%87%D0%B0%D1%82%D1%8C%20%D0%B4%D1%80%D1%83%D0%B3%D1%83%D1%8E.\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/tales\/Masha-rasteryasha\/<\/a><\/p>\n<p>  <\/p>\n<p>Admonition \u0435\u0449\u0435 \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c, \u0447\u0442\u043e\u0431\u044b \u0441\u043f\u0440\u044f\u0442\u0430\u0442\u044c \u043e\u0442\u0433\u0430\u0434\u043a\u0443 \u0437\u0430\u0433\u0430\u0434\u043a\u0438 &#171;\u043f\u043e\u0434 \u0441\u043f\u043e\u0439\u043b\u0435\u0440&#187;. \u0420\u0430\u0441\u043a\u0440\u044b\u0432\u0430\u0435\u043c\u044b\u0439 \u0441\u043f\u043e\u0439\u043b\u0435\u0440 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442\u0441\u044f, \u0435\u0441\u043b\u0438 \u043d\u0430\u0447\u0430\u0442\u044c \u0431\u043b\u043e\u043a \u0441 \u0442\u0440\u0435\u0445 \u0437\u043d\u0430\u043a\u043e\u0432 \u0432\u043e\u043f\u0440\u043e\u0441\u0430, \u0432\u043c\u0435\u0441\u0442\u043e \u0442\u0440\u0435\u0445 \u0432\u043e\u0441\u043a\u043b\u0438\u0446\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0445 \u0437\u043d\u0430\u043a\u043e\u0432.<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\">\u0421\u0430\u043c \u0432\u043e\u0434\u0430 \u0432\u043e\u0434\u0438\u0446\u0435\u0439,   \u0410 \u043a\u0438\u043f\u044f\u0442\u043a\u0430 \u0431\u043e\u0438\u0442\u0441\u044f...  ??? info \"\u041e\u0442\u0433\u0430\u0434\u043a\u0430\"     \u041b\u0451\u0434 <\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/riddles\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/riddles\/<\/a><\/p>\n<p>  <\/p>\n<h2 id=\"nochnoy-rezhim\">&#171;\u041d\u043e\u0447\u043d\u043e\u0439&#187; \u0440\u0435\u0436\u0438\u043c<\/h2>\n<p>  <\/p>\n<p>\u0421\u0435\u0439\u0447\u0430\u0441 \u043c\u043d\u043e\u0433\u0438\u0435 \u0441\u0430\u0439\u0442\u044b \u0437\u0430\u0431\u043e\u0442\u044f\u0442\u0441\u044f \u043e \u0433\u043b\u0430\u0437\u043a\u0430\u0445 \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u0435\u0439, \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u044f \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u0443\u044e \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0447\u0438\u0442\u0430\u0442\u044c \u0441\u0432\u0435\u0442\u043b\u044b\u0439 \u0442\u0435\u0441\u0442 \u043d\u0430 \u0442\u0435\u043c\u043d\u043e\u043c \u0444\u043e\u043d\u0435. \u0412 MkDocs Material \u044d\u0442\u043e \u043d\u0435\u0441\u043b\u043e\u0436\u043d\u043e \u0441\u0434\u0435\u043b\u0430\u0442\u044c:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">theme:     name: material     palette:     - media: \"(prefers-color-scheme: light)\"       scheme: default       toggle:         icon: material\/brightness-4         name: \u0422\u0435\u043c\u043d\u043e\u0435 \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u0435     - media: \"(prefers-color-scheme: dark)\"       scheme: slate       toggle:         icon: material\/brightness-7         name: \u0421\u0432\u0435\u0442\u043b\u043e\u0435 \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u0435<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442:<\/p>\n<p>  <\/p>\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/post_images\/895\/15b\/b81\/89515bb817b3b09ec10907bcd3bdfca8.png\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/895\/15b\/b81\/89515bb817b3b09ec10907bcd3bdfca8.png\"\/> <img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/post_images\/805\/e1b\/74f\/805e1b74f05171b92ae3312d6f8fd1e5.png\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/805\/e1b\/74f\/805e1b74f05171b92ae3312d6f8fd1e5.png\"\/><\/p>\n<p>  <\/p>\n<h2 id=\"ssylki-knopki\">\u0421\u0441\u044b\u043b\u043a\u0438-\u043a\u043d\u043e\u043f\u043a\u0438<\/h2>\n<p>  <\/p>\n<p>MkDocs \u0443\u043c\u0435\u0435\u0442 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c &#171;\u0437\u0430\u043c\u0435\u0442\u043d\u044b\u0435&#187; \u0441\u0441\u044b\u043b\u043a\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0432\u044b\u0433\u043b\u044f\u0434\u044f\u0442 \u043a\u0430\u043a \u043a\u0440\u0443\u043f\u043d\u044b\u0435 \u043a\u043d\u043e\u043f\u043e\u0447\u043a\u0438. \u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u0432\u043e\u0442 \u0442\u0430\u043a \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u043a\u043d\u043e\u043f\u043a\u0430 &#171;\u0447\u0438\u0442\u0430\u0442\u044c&#187; \u0441\u043e \u0437\u043d\u0430\u0447\u043a\u043e\u043c \u0440\u0430\u0441\u043a\u0440\u044b\u0442\u043e\u0439 \u043a\u043d\u0438\u0436\u043a\u0438:<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\">[:octicons-book-16: \u0427\u0438\u0442\u0430\u0442\u044c](coast-of-poetry.md){ .md-button }<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/poems\/#_4\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/poems\/<\/a><\/p>\n<p>  <\/p>\n<p>\u0412 MkDocs &#171;\u0438\u0437 \u043a\u043e\u0440\u043e\u0431\u043a\u0438&#187; <a href=\"https:\/\/squidfunk.github.io\/mkdocs-material\/reference\/icons-emojis\" rel=\"nofollow noopener noreferrer\">\u0434\u043e\u0441\u0442\u0443\u043f\u043d\u043e \u0431\u043e\u043b\u0435\u0435 10000 \u0438\u043a\u043e\u043d\u043e\u043a<\/a>.<\/p>\n<p>  <\/p>\n<h2 id=\"modifikaciya-css\">\u041c\u043e\u0434\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044f CSS<\/h2>\n<p>  <\/p>\n<p>\u0412\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u044b\u0435 \u0441\u0442\u0438\u043b\u0438 \u043c\u043e\u0436\u043d\u043e \u043b\u0435\u0433\u043a\u043e \u043a\u0430\u0441\u0442\u043e\u043c\u0438\u0437\u0438\u0442\u044c. \u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u043d\u0430\u0434\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c CSS-\u0444\u0430\u0439\u043b \u0441\u043e \u0441\u0432\u043e\u0438\u043c\u0438 \u0441\u0442\u0438\u043b\u044f\u043c\u0438 \u0438 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0438\u0442\u044c \u0435\u0433\u043e \u0432 <code>mkdocs.yaml<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">extra_css:     - extra-styles-v1.css<\/code><\/pre>\n<p>  <\/p>\n<p>\u041d\u043e\u043c\u0435\u0440 \u0432\u0435\u0440\u0441\u0438\u0438 \u0432 \u0438\u043c\u0435\u043d\u0438 \u0444\u0430\u0439\u043b\u0430 \u2014 \u044d\u0442\u043e \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u0445\u0430\u043a (workaround \u0434\u043b\u044f issue <a href=\"https:\/\/github.com\/mkdocs\/mkdocs\/issues\/1979\" rel=\"nofollow noopener noreferrer\">Cache Busting #1979<\/a>). \u041f\u0440\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f\u0445 \u0432 \u0441\u0442\u0438\u043b\u044f\u0445 \u043c\u043e\u0436\u043d\u043e \u043c\u0435\u043d\u044f\u0442\u044c \u043d\u043e\u043c\u0435\u0440, \u0438 \u0442\u0430\u043a\u0438\u043c \u043e\u0431\u0440\u0430\u0437\u043e\u043c \u0438\u0437\u0431\u0435\u0436\u0430\u0442\u044c &#171;\u0437\u0430\u0441\u0442\u0440\u0435\u0432\u0430\u043d\u0438\u044f&#187; \u0437\u0430\u043a\u0435\u0448\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u0441\u0442\u0430\u0440\u044b\u0445 \u0441\u0442\u0438\u043b\u0435\u0439 \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0430\u0445 \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u0435\u0439.<\/p>\n<p>  <\/p>\n<p>\u0412\u043e\u0442 \u0442\u0430\u043a, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0441\u0442\u0440\u043e\u0438\u0442\u044c &#171;\u043f\u043e\u0434 \u0441\u0435\u0431\u044f&#187; \u0432\u043d\u0435\u0448\u043d\u0438\u0439 \u0432\u0438\u0434 \u043a\u043d\u043e\u043f\u043e\u043a:<\/p>\n<p>  <\/p>\n<pre><code class=\"css\">.md-typeset .md-button {   border-radius: 0.3rem;   font-weight: 400;   font-size: 0.7rem;   padding: 0.25em 0.5em;   color: var(--link-color); }<\/code><\/pre>\n<p>  <\/p>\n<p>\u0410 \u0442\u0430\u043a \u2014 \u043f\u043e\u0434\u0442\u044e\u043d\u0438\u0442\u044c \u0432\u043d\u0435\u0448\u043d\u0438\u0439 \u0432\u0438\u0434 \u0441\u0441\u044b\u043b\u043e\u043a, \u0434\u043b\u044f &#171;\u0441\u0432\u0435\u0442\u043b\u043e\u0439&#187; \u0438 &#171;\u0442\u0435\u043c\u043d\u043e\u0439&#187; \u0442\u0435\u043c \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044f:<\/p>\n<p>  <\/p>\n<pre><code class=\"css\">:root {     --link-color: #115BC0; } .md-typeset a, .md-typeset a:hover {     color: var(--link-color); } .md-typeset a:hover:not(.md-button) {     text-decoration: underline; } [data-md-color-scheme=\"slate\"] {     --link-color: #58a6ff; }<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"vstavka-html\">\u0412\u0441\u0442\u0430\u0432\u043a\u0430 HTML<\/h2>\n<p>  <\/p>\n<p>\u0412\u0435\u0431\u0432\u0438\u0437\u043e\u0440 \u043f\u043e\u043a\u0430\u0437\u0430\u043b, \u0447\u0442\u043e \u043c\u043e\u0431\u0438\u043b\u044c\u043d\u044b\u0435 \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0438 \u043d\u0435 \u0432\u0441\u0435\u0433\u0434\u0430 \u043d\u0430\u0445\u043e\u0434\u044f\u0442 \u0438\u043a\u043e\u043d\u043a\u0443 &#171;\u0433\u0430\u043c\u0431\u0443\u0440\u0433\u0435\u0440\u0430&#187; \u0434\u043b\u044f \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u044f \u043e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u044f. \u0427\u0442\u043e\u0431\u044b \u0438\u043c \u043f\u043e\u043c\u043e\u0447\u044c, \u044f \u0440\u0435\u0448\u0438\u043b \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043d\u0430 \u0441\u0442\u0430\u0440\u0442\u043e\u0432\u0443\u044e \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0443 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0443\u044e \u043d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044e. \u0412 Markdown \u043c\u043e\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0442\u044c \u0444\u0440\u0430\u0433\u043c\u0435\u043d\u0442\u044b HTML, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0431\u0443\u0434\u0443\u0442 \u043f\u0435\u0440\u0435\u043d\u043e\u0441\u0438\u0442\u044c\u0441\u044f \u0432 \u0438\u0442\u043e\u0433\u043e\u0432\u044b\u0439 HTML &#171;\u043a\u0430\u043a \u0435\u0441\u0442\u044c&#187;. \u0427\u0442\u043e\u0431\u044b \u0431\u044b\u043b\u043e \u043a\u0440\u0430\u0441\u0438\u0432\u043e, \u0440\u0435\u0448\u0438\u043b \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c \u0442\u0430\u043a\u043e\u0439 \u043f\u043e\u0434\u0445\u043e\u0434.<\/p>\n<p>  <\/p>\n<p>HTML: <a href=\"https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/index.md?plain=1#L5-L42\" rel=\"nofollow noopener noreferrer\">https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/index.md?plain=1#L5-L42<\/a><\/p>\n<p>  <\/p>\n<p>CSS: <a href=\"https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/extra-styles-v1.css#L39-L62\" rel=\"nofollow noopener noreferrer\">https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/extra-styles-v1.css#L39-L62<\/a><\/p>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/<\/a><\/p>\n<p>  <\/p>\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/df9\/41a\/65d\/df941a65d863e6ba343b661f5d279419.gif\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/df9\/41a\/65d\/df941a65d863e6ba343b661f5d279419.gif\"\/><\/p>\n<p>  <\/p>\n<p>\u041f\u0440\u043e\u0448\u0443 \u043d\u0435 \u0431\u0440\u043e\u0441\u0430\u0442\u044c\u0441\u044f \u0442\u0430\u043f\u043a\u0430\u043c\u0438, \u044d\u0442\u043e \u043c\u043e\u0439 \u0447\u0443\u0442\u044c \u043b\u0438 \u043d\u0435 \u043f\u0435\u0440\u0432\u044b\u0439 \u043e\u043f\u044b\u0442 \u0445\u043e\u0442\u044c \u043a\u0430\u043a\u043e\u0439-\u0442\u043e \u0432\u0435\u0440\u0441\u0442\u043a\u0438 (\u043b\u0443\u0447\u0448\u0435 \u043f\u043e\u043c\u043e\u0433\u0438\u0442\u0435 \u0441\u043e\u0432\u0435\u0442\u043e\u043c). \u0422\u0435\u043c \u043d\u0435 \u043c\u0435\u043d\u0435\u0435, \u0432 \u0432\u0435\u0431\u0432\u0438\u0437\u043e\u0440\u0435 \u0432\u0438\u0434\u043d\u043e, \u0447\u0442\u043e \u043f\u043e\u0441\u0435\u0442\u0438\u0442\u0435\u043b\u0438 \u0441\u0430\u0439\u0442\u0430 \u0441\u0442\u0430\u043b\u0438 \u044d\u0442\u0438\u043c \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u0438 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0438\u0442\u044c \u043a \u0434\u0440\u0443\u0433\u0438\u043c \u0440\u0430\u0437\u0434\u0435\u043b\u0430\u043c.<\/p>\n<p>  <\/p>\n<h2 id=\"nemnogo-seo\">\u041d\u0435\u043c\u043d\u043e\u0433\u043e SEO<\/h2>\n<p>  <\/p>\n<p>\u0424\u0430\u0439\u043b <a href=\"https:\/\/developers.google.com\/search\/docs\/crawling-indexing\/sitemaps\/overview?hl=ru\" rel=\"nofollow noopener noreferrer\">sitemap<\/a> \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043e\u043f\u0442\u0438\u043c\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0441\u043a\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u043d\u0430\u0448\u0435\u0433\u043e \u0441\u0430\u0439\u0442\u0430 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u044b\u043c\u0438 \u0441\u0438\u0441\u0442\u0435\u043c\u0430\u043c\u0438. MkDocs \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u0444\u0430\u0439\u043b <code>sitemap.xml<\/code> \u0432 \u043a\u043e\u0440\u0435\u043d\u044c \u0441\u0430\u0439\u0442\u0430. \u041d\u043e, \u0434\u043b\u044f \u0442\u043e\u0433\u043e \u0447\u0442\u043e\u0431\u044b sitemap \u0441\u043e\u0434\u0435\u0440\u0436\u0430\u043b \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u044b\u0435 URL\u044b \u0441\u0442\u0440\u0430\u043d\u0438\u0446, \u043d\u0443\u0436\u043d\u043e \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0432 <code>mkdocs.yaml<\/code> \u0431\u0430\u0437\u043e\u0432\u044b\u0439 URL \u0441\u0430\u0439\u0442\u0430:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">site_url: https:\/\/lib-beliakova.github.io\/<\/code><\/pre>\n<p>  <\/p>\n<p>\u0427\u0442\u043e\u0431\u044b \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u0438\u043a\u0438 \u0441\u043c\u043e\u0433\u043b\u0438 \u043e\u0431\u043d\u0430\u0440\u0443\u0436\u0438\u0442\u044c \u043d\u0430\u0448 sitemap, \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u043c \u0432 \u043f\u0430\u043f\u043a\u0443 <code>docs<\/code> \u0444\u0430\u0439\u043b <code>robots.txt<\/code> \u0441\u043e \u0441\u0441\u044b\u043b\u043a\u043e\u0439 \u043d\u0430 <code>sitemap.xml<\/code>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">User-agent: * Sitemap: https:\/\/lib-beliakova.github.io\/sitemap.xml<\/code><\/pre>\n<p>  <\/p>\n<h2 id=\"osobennosti-ispolzovaniya-markdown-v-hudozhestvennyh-tekstah\">\u041e\u0441\u043e\u0431\u0435\u043d\u043d\u043e\u0441\u0442\u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f Markdown \u0432 \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0445 \u0442\u0435\u043a\u0441\u0442\u0430\u0445<\/h2>\n<p>  <\/p>\n<h3 id=\"punktuaciya-dlya-pryamoy-rechi-tire\">\u041f\u0443\u043d\u043a\u0442\u0443\u0430\u0446\u0438\u044f \u0434\u043b\u044f \u043f\u0440\u044f\u043c\u043e\u0439 \u0440\u0435\u0447\u0438 (\u0442\u0438\u0440\u0435)<\/h3>\n<p>  <\/p>\n<p>\u0412 \u043e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u0435 \u0442\u0435\u043a\u0441\u0442\u044b \u0438\u0437\u043e\u0431\u0438\u043b\u0443\u044e\u0442 \u043f\u0440\u044f\u043c\u043e\u0439 \u0440\u0435\u0447\u044c\u044e. \u0414\u043b\u044f \u043f\u0440\u0430\u0432\u0438\u043b\u044c\u043d\u043e\u0433\u043e \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u044f \u043f\u0440\u044f\u043c\u043e\u0439 \u0440\u0435\u0447\u0438 \u043d\u0443\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0442\u0438\u0440\u0435. \u0427\u0442\u043e\u0431\u044b \u043c\u043e\u044f \u044e\u043d\u0430\u044f \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c\u043d\u0438\u0446\u0430 \u043d\u0435 \u0437\u0430\u043c\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u043b\u0430\u0441\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u0440\u0430\u0437 \u0441\u043e \u0432\u0441\u0442\u0430\u0432\u043a\u043e\u0439 \u0441\u0438\u043c\u0432\u043e\u043b\u0430, \u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0433\u043e \u043d\u0430 \u043a\u043b\u0430\u0432\u0438\u0430\u0442\u0443\u0440\u0435, \u044f \u0434\u043e\u0431\u0430\u0432\u0438\u043b \u0432 \u043a\u043e\u043d\u0444\u0438\u0433\u0435 \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435 <a href=\"https:\/\/python-markdown.github.io\/extensions\/smarty\/\" rel=\"nofollow noopener noreferrer\">smarty<\/a>:<\/p>\n<p>  <\/p>\n<pre><code class=\"plaintext\">markdown_extensions:   - smarty<\/code><\/pre>\n<p>  <\/p>\n<p>\u041e\u043d\u043e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0434\u0432\u043e\u0439\u043d\u044b\u0435 \u0434\u0435\u0444\u0438\u0441\u044b \u0432 \u043a\u043e\u0440\u043e\u0442\u043a\u043e\u0435 \u0442\u0438\u0440\u0435 (en dash), \u0430 \u0442\u0440\u043e\u0439\u043d\u044b\u0435 \u2014 \u0432 \u0434\u043b\u0438\u043d\u043d\u043e\u0435 (em dash).<\/p>\n<p>  <\/p>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440 \u0442\u0435\u043a\u0441\u0442\u0430 \u0432 \u043c\u0430\u0440\u043a\u0434\u0430\u0443\u043d\u0435:<\/p>\n<p>  <\/p>\n<pre><code class=\"markdown\"># \u041e\u0434\u043d\u0430\u0436\u0434\u044b, \u043f\u043e\u0434 \u043d\u0430\u0448\u0438\u043c \u0434\u043e\u043c\u043e\u043c...  -- \u041d\u0438\u043d\u043a\u0430! \u0422\u044b \u043d\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0448\u044c, \u0447\u0442\u043e \u044f \u043d\u0430\u0448\u0451\u043b!  \u042f \u0432\u0437\u0434\u0440\u043e\u0433\u043d\u0443\u043b\u0430 \u043e\u0442 \u0421\u0435\u0440\u0451\u0433\u0438\u043d\u043e\u0433\u043e \u0432\u043e\u043f\u043b\u044f.  -- \u041d\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u044f\u044e, \u043a\u0430\u043a \u0438 \u0442\u043e, \u0437\u0430\u0447\u0435\u043c \u0442\u044b \u0442\u0430\u043a \u043e\u0440\u0451\u0448\u044c.  -- \u041d\u0443 \u0445\u0432\u0430\u0442\u0438\u0442 \u043d\u0443\u0434\u0435\u0442\u044c! \u041f\u043e\u0448\u043b\u0438 \u043f\u043e\u043a\u0430\u0436\u0443!<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/stories\/under-our-house\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/stories\/under-our-house\/<\/a><\/p>\n<p>  <\/p>\n<h3 id=\"tipografskie-kavychki-i-mnogotochiya\">&#171;\u0422\u0438\u043f\u043e\u0433\u0440\u0430\u0444\u0441\u043a\u0438\u0435&#187; \u043a\u0430\u0432\u044b\u0447\u043a\u0438 \u0438 \u043c\u043d\u043e\u0433\u043e\u0442\u043e\u0447\u0438\u044f<\/h3>\n<p>  <\/p>\n<p>\u0417\u0430\u043e\u0434\u043d\u043e, \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0435 smarty \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442 &#171;\u043a\u043e\u043c\u043f\u044c\u044e\u0442\u0435\u0440\u043d\u044b\u0435&#187; \u043f\u0440\u044f\u043c\u044b\u0435 \u043a\u0430\u0432\u044b\u0447\u043a\u0438 \u0432 &#171;\u0442\u0438\u043f\u043e\u0433\u0440\u0430\u0444\u0441\u043a\u0438\u0435&#187;, \u0430 \u0442\u0440\u043e\u0435\u0442\u043e\u0447\u0438\u044f, \u043d\u0430\u0431\u0440\u0430\u043d\u043d\u044b\u0435 \u0442\u0440\u0435\u043c\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u043c\u0438 \u0442\u043e\u0447\u043a\u0430\u043c\u0438 \u2014 \u0432 \u043e\u0434\u0438\u043d \u0441\u0438\u043c\u0432\u043e\u043b ellipsis. \u041d\u0430 \u043f\u0435\u0440\u0432\u044b\u0439 \u0432\u0437\u0433\u043b\u044f\u0434 \u044d\u0442\u043e \u043a\u0430\u0436\u0435\u0442\u0441\u044f \u0435\u0440\u0443\u043d\u0434\u043e\u0439, \u043d\u043e \u043f\u043e \u0444\u0430\u043a\u0442\u0443 \u0437\u0434\u043e\u0440\u043e\u0432\u043e \u043e\u0431\u043b\u0435\u0433\u0447\u0430\u0435\u0442 \u0436\u0438\u0437\u043d\u044c, \u0435\u0441\u043b\u0438 \u0437\u0430\u0445\u043e\u0447\u0435\u0442\u0441\u044f \u043d\u0430\u043f\u0435\u0447\u0430\u0442\u0430\u0442\u044c \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0443\u044e \u043a\u043d\u0438\u0433\u0443 \u0432 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0439 \u0442\u0438\u043f\u043e\u0433\u0440\u0430\u0444\u0438\u0438 (\u0441\u043f\u043e\u0439\u043b\u0435\u0440: <a href=\"https:\/\/t.me\/lib_beliakova\/22\" rel=\"nofollow noopener noreferrer\">\u0437\u0430\u0445\u043e\u0442\u0435\u043b\u043e\u0441\u044c, \u043d\u0430\u043f\u0435\u0447\u0430\u0442\u0430\u043b\u0438<\/a>).<\/p>\n<p>  <\/p>\n<h3 id=\"perevody-strok-v-stihah\">\u041f\u0435\u0440\u0435\u0432\u043e\u0434\u044b \u0441\u0442\u0440\u043e\u043a \u0432 \u0441\u0442\u0438\u0445\u0430\u0445<\/h3>\n<p>  <\/p>\n<p>\u0414\u043b\u044f \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044f \u0441\u0442\u0438\u0445\u043e\u0432 \u043d\u0443\u0436\u043d\u043e \u0443\u043c\u0435\u0442\u044c \u0432\u0441\u0442\u0430\u0432\u043b\u044f\u0442\u044c \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u044b \u0441\u0442\u0440\u043e\u043a, \u043d\u0435 \u0437\u0430\u0432\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0442\u044c \u0436\u0435 \u043a\u0430\u0436\u0434\u0443\u044e \u0441\u0442\u0438\u0445\u043e\u0442\u0432\u043e\u0440\u043d\u0443\u044e \u0441\u0442\u0440\u043e\u043a\u0443 \u0432 \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u044b\u0439 \u043f\u0430\u0440\u0430\u0433\u0440\u0430\u0444. \u041d\u0430 \u043f\u0435\u0440\u0432\u044b\u0439 \u0432\u0437\u0433\u043b\u044f\u0434, \u0442\u0443\u0442 \u043d\u0435\u043f\u043e\u043d\u044f\u0442\u043d\u043e \u043a\u0430\u043a \u043f\u043e\u0441\u0442\u0443\u043f\u0438\u0442\u044c, \u0432\u0435\u0434\u044c \u043e\u0434\u0438\u043d\u043e\u0447\u043d\u044b\u0439 \u043f\u0435\u0440\u0435\u0432\u043e\u0434 \u0441\u0442\u0440\u043e\u043a\u0438 \u0432 Markdown \u043f\u0440\u0435\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u043f\u0440\u043e\u0431\u0435\u043b \u0432 HTML. \u0410 \u0434\u0432\u043e\u0439\u043d\u043e\u0439 \u043f\u0435\u0440\u0435\u0432\u043e\u0434 \u0441\u0442\u0440\u043e\u043a\u0438 \u0441\u043e\u0437\u0434\u0430\u0435\u0442 \u043d\u043e\u0432\u044b\u0439 \u043f\u0430\u0440\u0430\u0433\u0440\u0430\u0444 <code>&lt;p><\/code>.<\/p>\n<p>  <\/p>\n<p>\u0422\u0435\u043c \u043d\u0435 \u043c\u0435\u043d\u0435\u0435, \u0435\u0441\u0442\u044c \u0442\u0440\u0438 \u0441\u043f\u043e\u0441\u043e\u0431\u0430 \u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f \u043f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u044f <code>&lt;br><\/code> \u0432 \u0438\u0442\u043e\u0433\u043e\u0432\u043e\u043c HTML:<\/p>\n<p>  <\/p>\n<ol>\n<li>\u0417\u0430\u043a\u043e\u043d\u0447\u0438\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u0443 \u0432 Markdown \u0434\u0432\u0443\u043c\u044f \u043f\u0440\u043e\u0431\u0435\u043b\u0430\u043c\u0438.<\/li>\n<li>\u0417\u0430\u043a\u043e\u043d\u0447\u0438\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u0443 \u0432 Markdown \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u043c <code>\\<\/code> (\u0442.\u0435 \u043a\u0430\u043a \u0431\u044b \u0437\u0430\u044d\u043a\u0440\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043f\u043e\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u043f\u0435\u0440\u0435\u0432\u043e\u0434 \u0441\u0442\u0440\u043e\u043a\u0438).<\/li>\n<li>\u041f\u0440\u043e\u0441\u0442\u043e \u0432\u0441\u0442\u0430\u0432\u0438\u0442\u044c <code>&lt;br><\/code> \u0432 Markdown.<\/li>\n<\/ol>\n<p>  <\/p>\n<p>\u041c\u044b \u0432\u044b\u0431\u0440\u0430\u043b\u0438 \u043f\u0435\u0440\u0432\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431. \u0425\u043e\u0442\u044c \u043e\u043d \u0438 \u043c\u0435\u043d\u0435\u0435 \u043e\u0447\u0435\u0432\u0438\u0434\u043d\u044b\u0439, \u043d\u043e \u043e\u043d \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 \u0447\u0435\u043b\u043e\u0432\u0435\u043a\u043e\u0447\u0438\u0442\u0430\u0435\u043c\u043e\u0441\u0442\u044c \u0442\u0435\u043a\u0441\u0442\u0430 \u0432 \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435.<\/p>\n<p>  <\/p>\n<p>\u041f\u0440\u0438\u043c\u0435\u0440 \u043e\u0444\u043e\u0440\u043c\u043b\u0435\u043d\u0438\u044f \u0441\u0442\u0438\u0445\u0430 \u0432 Markdown:<\/p>\n<p>  <\/p>\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/post_images\/9ed\/5ed\/636\/9ed5ed636c7636f997e5e6b9658c9278.png\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/9ed\/5ed\/636\/9ed5ed636c7636f997e5e6b9658c9278.png\"\/><\/p>\n<p>  <\/p>\n<p>\u0422\u0443\u0442 \u044f \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e \u0441\u043a\u0440\u0438\u043d\u0448\u043e\u0442 \u0438\u0437 VS Code, \u0447\u0442\u043e\u0431\u044b \u0431\u044b\u043b\u043e \u0432\u0438\u0434\u043d\u043e \u043f\u0440\u043e\u0431\u0435\u043b\u044b, \u0441\u043e\u0437\u0434\u0430\u044e\u0449\u0438\u0435 \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u044b \u0441\u0442\u0440\u043e\u043a.<\/p>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/poems\/it-was-autumn\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/poems\/it-was-autumn\/<\/a><\/p>\n<p>  <\/p>\n<h2 id=\"illyustracii\">\u0418\u043b\u043b\u044e\u0441\u0442\u0440\u0430\u0446\u0438\u0438<\/h2>\n<p>  <\/p>\n<p>\u0420\u0438\u0441\u043e\u0432\u0430\u0442\u044c \u0432 \u0441\u0435\u043c\u044c\u0435 \u043d\u0438\u043a\u0442\u043e \u043d\u0435 \u0443\u043c\u0435\u0435\u0442. \u041f\u043e\u044d\u0442\u043e\u043c\u0443 \u0432\u044b\u0431\u043e\u0440 \u043f\u0430\u043b \u043d\u0430 \u0445\u0443\u0434\u043e\u0436\u043d\u0438\u043a\u0430, \u043e \u043a\u043e\u0442\u043e\u0440\u043e\u043c \u0432\u0441\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u0438 \u0433\u043e\u0432\u043e\u0440\u044f\u0442 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0435 \u0432\u0440\u0435\u043c\u044f \u2014 Midjourney. \u0414\u0435\u0441\u044f\u0442\u0438\u0434\u043e\u043b\u043b\u0430\u0440\u043e\u0432\u043e\u0439 \u043f\u043e\u0434\u043f\u0438\u0441\u043a\u0438 \u0445\u0432\u0430\u0442\u0438\u043b\u043e, \u0447\u0442\u043e\u0431\u044b \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u043f\u043e\u043b\u0441\u043e\u0442\u043d\u0438 \u0440\u0438\u0441\u0443\u043d\u043a\u043e\u0432 \u0438 \u043f\u0440\u043e\u0438\u043b\u043b\u044e\u0441\u0442\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043a\u0430\u0436\u0434\u044b\u0439 \u0441\u0442\u0438\u0448\u043e\u043a \u0438 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0438\u043a \u043d\u0430 \u0441\u0430\u0439\u0442\u0435.<\/p>\n<p>  <\/p>\n<p>\u041f\u0440\u043e \u0440\u0430\u0431\u043e\u0442\u0443 \u0441 Midjourney \u0443\u0436\u0435 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043e \u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u043e \u0441\u0442\u0430\u0442\u0435\u0439, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043d\u0435 \u0431\u0443\u0434\u0443 \u0432\u0434\u0430\u0432\u0430\u0442\u044c\u0441\u044f \u0432 \u0434\u0435\u0442\u0430\u043b\u0438. \u0427\u0442\u043e\u0431\u044b \u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f \u0435\u0434\u0438\u043d\u043e\u0433\u043e \u0441\u0442\u0438\u043b\u044f \u0438\u043b\u043b\u044e\u0441\u0442\u0440\u0430\u0446\u0438\u0439, \u043f\u043e\u0434\u0445\u043e\u0434\u044f\u0449\u0435\u0433\u043e \u043a \u0434\u0435\u0442\u0441\u043a\u043e\u0439 \u043b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u0435, \u043a \u043a\u0430\u0436\u0434\u043e\u043c\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0443 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u043b\u0438 &#171;watercolor painting style&#187;. \u041f\u043e\u043b\u0443\u0447\u0438\u043b\u0438\u0441\u044c \u043a\u0430\u043a-\u0431\u044b-\u0430\u043a\u0432\u0430\u0440\u0435\u043b\u044c\u043d\u044b\u0435 \u0440\u0438\u0441\u0443\u043d\u043a\u0438, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u043e\u0442\u043e\u043c \u0438 \u0434\u043b\u044f <a href=\"https:\/\/t.me\/lib_beliakova\/22\" rel=\"nofollow noopener noreferrer\">&#171;\u0444\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u043e\u0439&#187; \u043a\u043d\u0438\u0433\u0438<\/a> \u043f\u0440\u0438\u0433\u043e\u0434\u0438\u043b\u0438\u0441\u044c.<\/p>\n<p>  <\/p>\n<h2 id=\"audio\">\u0410\u0443\u0434\u0438\u043e<\/h2>\n<p>  <\/p>\n<p>\u0412\u043e\u0437\u043d\u0438\u043a\u043b\u0430 \u0438\u0434\u0435\u044f \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u0430\u0443\u0434\u0438\u043e\u0441\u043a\u0430\u0437\u043a\u0438, \u0447\u0442\u043e\u0431\u044b \u043a \u0447\u0438\u0442\u0430\u0442\u0435\u043b\u044f\u043c \u0434\u043e\u0431\u0430\u0432\u0438\u043b\u0438\u0441\u044c \u0442\u0430\u043a\u0436\u0435 \u0441\u043b\u0443\u0448\u0430\u0442\u0435\u043b\u0438. \u0412 Markdown \u043d\u0435\u0442 \u0430\u043d\u0430\u043b\u043e\u0433\u0430 \u0442\u0435\u0433\u0430 <code>&lt;audio><\/code>, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u0434\u043b\u044f \u0432\u0441\u0442\u0430\u0432\u043a\u0438 \u043f\u043b\u0435\u0435\u0440\u0430 \u043f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0447\u0438\u0441\u0442\u044b\u0439 HTML: <a href=\"https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/tales\/Masha-rasteryasha.md?plain=1#L3-L9\" rel=\"nofollow noopener noreferrer\">https:\/\/github.com\/lib-beliakova\/lib-beliakova.github.io\/blob\/main\/docs\/tales\/Masha-rasteryasha.md?plain=1#L3-L9<\/a><\/p>\n<p>  <\/p>\n<p>\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442: <a href=\"https:\/\/lib-beliakova.github.io\/tales\/Masha-rasteryasha\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/tales\/Masha-rasteryasha\/<\/a><\/p>\n<p>  <\/p>\n<p>\u0412 \u044d\u0442\u043e\u043c \u043f\u0440\u0438\u043c\u0435\u0440\u0435 \u043f\u043b\u0435\u0435\u0440 &#171;\u0437\u0430\u0432\u0435\u0440\u043d\u0443\u0442&#187; \u0432 \u043d\u0435\u0441\u0442\u0430\u043d\u0434\u0430\u0440\u0442\u043d\u044b\u0439 adm\u043enition \u0442\u0438\u043f\u0430 &#171;audio&#187;. \u042d\u0442\u043e, \u0440\u0430\u0437\u0443\u043c\u0435\u0435\u0442\u0441\u044f, \u043d\u0435 \u0432\u0430\u0436\u043d\u043e \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u043f\u043b\u0435\u0435\u0440\u0430. \u0421\u0434\u0435\u043b\u0430\u043d\u043e \u0447\u0438\u0441\u0442\u043e \u0438\u0437 \u044d\u0441\u0442\u0435\u0442\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u0441\u043e\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0439, \u0447\u0442\u043e\u0431\u044b \u0443 \u043f\u043b\u0435\u0435\u0440\u0430 \u0431\u044b\u043b\u0430 \u0440\u0430\u043c\u043e\u0447\u043a\u0430, \u043f\u043e\u0434\u043f\u0438\u0441\u044c \u0438 \u0438\u043a\u043e\u043d\u043a\u0430 \u0441 \u043d\u0430\u0443\u0448\u043d\u0438\u043a\u0430\u043c\u0438. \u041d\u0435 \u0431\u0443\u0434\u0443 \u0437\u0434\u0435\u0441\u044c \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043f\u0440\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044e \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u043e\u0433\u043e \u0442\u0438\u043f\u0430 admoinition, \u0447\u0442\u043e\u0431\u044b \u043d\u0435 \u0440\u0430\u0441\u0442\u044f\u0433\u0438\u0432\u0430\u0442\u044c \u0438 \u0431\u0435\u0437 \u0442\u043e\u0433\u043e \u0434\u043b\u0438\u043d\u043d\u0443\u044e \u0441\u0442\u0430\u0442\u044c\u044e. \u0415\u0441\u043b\u0438 \u043a\u043e\u043c\u0443 \u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043d\u043e, \u043f\u0438\u0448\u0438\u0442\u0435, \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u0432 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u0445.<\/p>\n<p>  <\/p>\n<h2 id=\"zaklyuchenie\">\u0417\u0430\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u0435<\/h2>\n<p>  <\/p>\n<p>\u041e\u043a\u0430\u0437\u0430\u043b\u043e\u0441\u044c, \u0447\u0442\u043e &#171;\u043d\u0435\u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0439&#187; \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c \u0442\u043e\u0436\u0435 \u043c\u043e\u0436\u0435\u0442 \u044d\u0444\u0444\u0435\u043a\u0442\u0438\u0432\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c Docs as Code \u0434\u043b\u044f \u0431\u044b\u0441\u0442\u0440\u043e\u0439 \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u0438 \u0441\u0432\u043e\u0438\u0445 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u0439. \u0412 \u0442\u043e \u0436\u0435 \u0432\u0440\u0435\u043c\u044f, \u043c\u043d\u043e\u0433\u0438\u0435 <em>\u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u0435<\/em> \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u0438 &#171;\u0441\u0442\u0430\u0440\u043e\u0439 \u0437\u0430\u043a\u0430\u043b\u043a\u0438&#187; \u0441 \u043e\u0441\u0442\u043e\u0440\u043e\u0436\u043d\u043e\u0441\u0442\u044c\u044e \u043f\u0440\u0438\u0441\u043c\u0430\u0442\u0440\u0438\u0432\u0430\u044e\u0442\u0441\u044f \u043a \u044d\u0442\u043e\u043c\u0443 \u043f\u043e\u0434\u0445\u043e\u0434\u0443. \u0421\u043c\u0435\u043b\u0435\u0435, \u043d\u0438\u0447\u0435\u0433\u043e \u0441\u0442\u0440\u0430\u0448\u043d\u043e\u0433\u043e \u0442\u0443\u0442 \u043d\u0435\u0442, \u0434\u0430\u0436\u0435 \u0440\u0435\u0431\u0435\u043d\u043e\u043a \u0441\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u0442\u0441\u044f \ud83d\ude42 \u042f \u0443\u0436\u0435 \u0434\u0430\u0432\u043d\u043e \u043d\u0435 \u043f\u043e\u043c\u043e\u0433\u0430\u044e \u0438 \u043d\u0435 \u0441\u0442\u043e\u044e \u043d\u0430 \u043f\u043e\u0434\u0445\u0432\u0430\u0442\u0435. \u0414\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u043d\u043e\u0432\u044b\u0439 \u0444\u0430\u0439\u043b, \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442, \u0437\u0430\u0442\u0435\u043c \u043a\u043e\u043c\u043c\u0438\u0442, \u043f\u0443\u0448\u2026 \u0418 \u0433\u043e\u0442\u043e\u0432\u043e, \u043d\u043e\u0432\u044b\u0439 \u043a\u043e\u043d\u0442\u0435\u043d\u0442 \u0432 \u043f\u0440\u043e\u0434\u0430\u043a\u0448\u043d\u0435!<\/p>\n<p>  <\/p>\n<p>\u0422\u0430\u043a\u0436\u0435 \u0445\u043e\u0447\u0443 \u043f\u0435\u0440\u0435\u0434\u0430\u0442\u044c \u0431\u043b\u0430\u0433\u043e\u0434\u0430\u0440\u043d\u043e\u0441\u0442\u044c \u0412\u043b\u0430\u0434\u0438\u0441\u043b\u0430\u0432\u0443 <a href=\"https:\/\/habr.com\/ru\/users\/himura\/\" class=\"user_link\">Himura<\/a> \u0437\u0430 \u0442\u043e, \u0447\u0442\u043e \u0432 \u0441\u0432\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u043b \u0441 MkDocs.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<p> <!----> <!----><\/div>\n<p> <!----> <!----><br \/> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/post\/720584\/\"> https:\/\/habr.com\/ru\/post\/720584\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<div><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-1\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">\n<p><img decoding=\"async\" src=\"https:\/\/habrastorage.org\/r\/w1560\/getpro\/habr\/post_images\/cd2\/21e\/8c2\/cd221e8c2cbc1d5646284a1c9cf24d19.png\" data-src=\"https:\/\/habrastorage.org\/getpro\/habr\/post_images\/cd2\/21e\/8c2\/cd221e8c2cbc1d5646284a1c9cf24d19.png\"\/><\/p>\n<p>  <\/p>\n<p>Docs as \u0421ode \u2014 \u043f\u043e\u0434\u0445\u043e\u0434 \u043a \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0442\u0435\u043a\u0441\u0442\u0430\u043c\u0438, \u043f\u043e\u0434\u0440\u0430\u0437\u0443\u043c\u0435\u0432\u0430\u044e\u0449\u0438\u0439 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u0442\u0435\u043a\u0441\u0442\u0430 \u043a\u0430\u043a \u043a\u043e\u0434\u0430:<\/p>\n<p>  <\/p>\n<ul>\n<li>\u0432 \u043f\u0440\u043e\u0441\u0442\u043e\u043c \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u043e\u043c \u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440\u0435 \u0438\u043b\u0438 IDE;<\/li>\n<li>\u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u0438\u0441\u0442\u0435\u043c\u044b \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044f \u0432\u0435\u0440\u0441\u0438\u0439;<\/li>\n<li>\u0441 CI \/ CD \/ Code Review.<\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u0412 \u043d\u0430\u0441\u0442\u043e\u044f\u0449\u0435\u0435 \u0432\u0440\u0435\u043c\u044f Docs as Code \u0448\u0438\u0440\u043e\u043a\u043e \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u0440\u0438 \u0440\u0430\u0431\u043e\u0442\u0435 \u0441 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439, \u0434\u0430\u0432\u0430\u044f \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u043c \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044f\u043c \u0438 \u043f\u0440\u043e\u0435\u043a\u0442\u043d\u044b\u043c \u043a\u043e\u043c\u0430\u043d\u0434\u0430\u043c \u043c\u0430\u0441\u0441\u0443 \u0443\u0434\u043e\u0431\u0441\u0442\u0432 \u0438 \u043f\u0440\u0435\u0438\u043c\u0443\u0449\u0435\u0441\u0442\u0432.<\/p>\n<p>  <\/p>\n<p>\u041d\u043e \u0447\u0442\u043e \u0435\u0441\u043b\u0438 \u043f\u043e\u0439\u0442\u0438 \u0434\u0430\u043b\u044c\u0448\u0435, \u043f\u043e\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0442\u044c \u0442\u0430\u043a\u043e\u0439 \u043f\u043e\u0434\u0445\u043e\u0434 \u043d\u0435 \u0441 \u0442\u0435\u0445\u043d\u0438\u0447\u0435\u0441\u043a\u0438\u043c\u0438, \u0430 \u0441 \u0445\u0443\u0434\u043e\u0436\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u044b\u043c\u0438 \u0442\u0435\u043a\u0441\u0442\u0430\u043c\u0438? \u0427\u0442\u043e \u0435\u0441\u043b\u0438 \u0430\u0432\u0442\u043e\u0440 \u2014 \u043d\u0435 \u0442\u0435\u0445\u043d\u0430\u0440\u044c \u0438 \u043d\u0435 \u0430\u0439\u0442\u0438\u0448\u043d\u0438\u043a? \u041f\u0440\u043e\u0441\u0442\u043e \u044e\u043d\u044b\u0439 \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0449\u0438\u0439 \u043f\u0438\u0441\u0430\u0442\u0435\u043b\u044c, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u043e\u0431\u0443\u0435\u0442 \u043f\u0438\u0441\u0430\u0442\u044c \u043f\u0440\u043e\u0437\u0443 \u0438 \u0441\u0442\u0438\u0445\u0438 \u0440\u0443\u0447\u043a\u043e\u0439 \u043d\u0430 \u0431\u0443\u043c\u0430\u0433\u0435, \u0438 \u043d\u0430\u0434\u0435\u0435\u0442\u0441\u044f \u043f\u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u044c \u0448\u0438\u0440\u043e\u043a\u0443\u044e \u043f\u0443\u0431\u043b\u0438\u043a\u0443 \u0441\u043e \u0441\u0432\u043e\u0438\u043c \u0442\u0432\u043e\u0440\u0447\u0435\u0441\u0442\u0432\u043e\u043c?<\/p>\n<p>  <\/p>\n<p>\u0412 \u044d\u0442\u043e\u0439 \u0441\u0442\u0430\u0442\u044c\u0435 \u044f \u0440\u0430\u0441\u0441\u043a\u0430\u0436\u0443 \u043e \u0442\u0430\u043a\u043e\u043c \u044d\u043a\u0441\u043f\u0435\u0440\u0438\u043c\u0435\u043d\u0442\u0435 (\u0437\u0430\u0431\u0435\u0433\u0430\u044f \u0432\u043f\u0435\u0440\u0435\u0434, \u0443\u0434\u0430\u0447\u043d\u043e\u043c). \u041c\u043e\u0435\u0439 \u0434\u043e\u0447\u0435\u0440\u0438 11 \u043b\u0435\u0442, \u043e\u043d\u0430 \u043f\u0438\u0448\u0435\u0442 \u0441\u043a\u0430\u0437\u043a\u0438, \u0441\u0442\u0438\u0445\u0438 \u0438 \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u044b. \u0427\u0442\u043e\u0431\u044b \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0435\u0435 \u0443\u0432\u043b\u0435\u0447\u0435\u043d\u0438\u0435, \u044f \u043f\u043e\u043c\u043e\u0433 \u0435\u0439 \u0441\u043e\u0437\u0434\u0430\u0442\u044c \u043b\u0438\u0442\u0435\u0440\u0430\u0442\u0443\u0440\u043d\u044b\u0439 \u0441\u0430\u0439\u0442, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044f \u043f\u043e\u0434\u0445\u043e\u0434 Docs as Code. \u041e\u043d\u0430 \u0443\u0441\u043f\u0435\u0448\u043d\u043e \u043e\u0441\u0432\u043e\u0438\u043b\u0430 \u043e\u0441\u043d\u043e\u0432\u044b Markdown \u0438 Git. \u0421\u0435\u0439\u0447\u0430\u0441 \u043e\u043d\u0430 \u0441\u0430\u043c\u043e\u0441\u0442\u043e\u044f\u0442\u0435\u043b\u044c\u043d\u043e \u043f\u0443\u0431\u043b\u0438\u043a\u0443\u0435\u0442 \u043d\u043e\u0432\u044b\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u0435\u0434\u0435\u043d\u0438\u044f \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u043d\u043e\u0432\u043e\u0441\u0442\u0438 \u043d\u0430 \u0441\u0432\u043e\u0435\u043c \u0441\u0430\u0439\u0442\u0435 <a href=\"https:\/\/lib-beliakova.github.io\/\" rel=\"nofollow noopener noreferrer\">https:\/\/lib-beliakova.github.io\/<\/a>.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-346330","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/346330","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=346330"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/346330\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=346330"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=346330"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=346330"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}