mirror of
https://github.com/SantaSpeen/santaspeen.ru-blog.git
synced 2026-10-28 15:10:05 +00:00
blog-setup
This commit is contained in:
SantaSpeen committed
1 parent
ea24b3547b
commit
69b78a41a2
8 files changed
+205
-55
No files matched your search
@@ -0,0 +1 @@
|
||||
<svg width="77" height="19" aria-label="Algolia" role="img" id="Layer_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 2196.2 500"><defs><style>.cls-1,.cls-2{fill:#003dff;}.cls-2{fill-rule:evenodd;}</style></defs><path class="cls-2" d="M1070.38,275.3V5.91c0-3.63-3.24-6.39-6.82-5.83l-50.46,7.94c-2.87,.45-4.99,2.93-4.99,5.84l.17,273.22c0,12.92,0,92.7,95.97,95.49,3.33,.1,6.09-2.58,6.09-5.91v-40.78c0-2.96-2.19-5.51-5.12-5.84-34.85-4.01-34.85-47.57-34.85-54.72Z"></path><rect class="cls-1" x="1845.88" y="104.73" width="62.58" height="277.9" rx="5.9" ry="5.9"></rect><path class="cls-2" d="M1851.78,71.38h50.77c3.26,0,5.9-2.64,5.9-5.9V5.9c0-3.62-3.24-6.39-6.82-5.83l-50.77,7.95c-2.87,.45-4.99,2.92-4.99,5.83v51.62c0,3.26,2.64,5.9,5.9,5.9Z"></path><path class="cls-2" d="M1764.03,275.3V5.91c0-3.63-3.24-6.39-6.82-5.83l-50.46,7.94c-2.87,.45-4.99,2.93-4.99,5.84l.17,273.22c0,12.92,0,92.7,95.97,95.49,3.33,.1,6.09-2.58,6.09-5.91v-40.78c0-2.96-2.19-5.51-5.12-5.84-34.85-4.01-34.85-47.57-34.85-54.72Z"></path><path class="cls-2" d="M1631.95,142.72c-11.14-12.25-24.83-21.65-40.78-28.31-15.92-6.53-33.26-9.85-52.07-9.85-18.78,0-36.15,3.17-51.92,9.85-15.59,6.66-29.29,16.05-40.76,28.31-11.47,12.23-20.38,26.87-26.76,44.03-6.38,17.17-9.24,37.37-9.24,58.36,0,20.99,3.19,36.87,9.55,54.21,6.38,17.32,15.14,32.11,26.45,44.36,11.29,12.23,24.83,21.62,40.6,28.46,15.77,6.83,40.12,10.33,52.4,10.48,12.25,0,36.78-3.82,52.7-10.48,15.92-6.68,29.46-16.23,40.78-28.46,11.29-12.25,20.05-27.04,26.25-44.36,6.22-17.34,9.24-33.22,9.24-54.21,0-20.99-3.34-41.19-10.03-58.36-6.38-17.17-15.14-31.8-26.43-44.03Zm-44.43,163.75c-11.47,15.75-27.56,23.7-48.09,23.7-20.55,0-36.63-7.8-48.1-23.7-11.47-15.75-17.21-34.01-17.21-61.2,0-26.89,5.59-49.14,17.06-64.87,11.45-15.75,27.54-23.52,48.07-23.52,20.55,0,36.63,7.78,48.09,23.52,11.47,15.57,17.36,37.98,17.36,64.87,0,27.19-5.72,45.3-17.19,61.2Z"></path><path class="cls-2" d="M894.42,104.73h-49.33c-48.36,0-90.91,25.48-115.75,64.1-14.52,22.58-22.99,49.63-22.99,78.73,0,44.89,20.13,84.92,51.59,111.1,2.93,2.6,6.05,4.98,9.31,7.14,12.86,8.49,28.11,13.47,44.52,13.47,1.23,0,2.46-.03,3.68-.09,.36-.02,.71-.05,1.07-.07,.87-.05,1.75-.11,2.62-.2,.34-.03,.68-.08,1.02-.12,.91-.1,1.82-.21,2.73-.34,.21-.03,.42-.07,.63-.1,32.89-5.07,61.56-30.82,70.9-62.81v57.83c0,3.26,2.64,5.9,5.9,5.9h50.42c3.26,0,5.9-2.64,5.9-5.9V110.63c0-3.26-2.64-5.9-5.9-5.9h-56.32Zm0,206.92c-12.2,10.16-27.97,13.98-44.84,15.12-.16,.01-.33,.03-.49,.04-1.12,.07-2.24,.1-3.36,.1-42.24,0-77.12-35.89-77.12-79.37,0-10.25,1.96-20.01,5.42-28.98,11.22-29.12,38.77-49.74,71.06-49.74h49.33v142.83Z"></path><path class="cls-2" d="M2133.97,104.73h-49.33c-48.36,0-90.91,25.48-115.75,64.1-14.52,22.58-22.99,49.63-22.99,78.73,0,44.89,20.13,84.92,51.59,111.1,2.93,2.6,6.05,4.98,9.31,7.14,12.86,8.49,28.11,13.47,44.52,13.47,1.23,0,2.46-.03,3.68-.09,.36-.02,.71-.05,1.07-.07,.87-.05,1.75-.11,2.62-.2,.34-.03,.68-.08,1.02-.12,.91-.1,1.82-.21,2.73-.34,.21-.03,.42-.07,.63-.1,32.89-5.07,61.56-30.82,70.9-62.81v57.83c0,3.26,2.64,5.9,5.9,5.9h50.42c3.26,0,5.9-2.64,5.9-5.9V110.63c0-3.26-2.64-5.9-5.9-5.9h-56.32Zm0,206.92c-12.2,10.16-27.97,13.98-44.84,15.12-.16,.01-.33,.03-.49,.04-1.12,.07-2.24,.1-3.36,.1-42.24,0-77.12-35.89-77.12-79.37,0-10.25,1.96-20.01,5.42-28.98,11.22-29.12,38.77-49.74,71.06-49.74h49.33v142.83Z"></path><path class="cls-2" d="M1314.05,104.73h-49.33c-48.36,0-90.91,25.48-115.75,64.1-11.79,18.34-19.6,39.64-22.11,62.59-.58,5.3-.88,10.68-.88,16.14s.31,11.15,.93,16.59c4.28,38.09,23.14,71.61,50.66,94.52,2.93,2.6,6.05,4.98,9.31,7.14,12.86,8.49,28.11,13.47,44.52,13.47h0c17.99,0,34.61-5.93,48.16-15.97,16.29-11.58,28.88-28.54,34.48-47.75v50.26h-.11v11.08c0,21.84-5.71,38.27-17.34,49.36-11.61,11.08-31.04,16.63-58.25,16.63-11.12,0-28.79-.59-46.6-2.41-2.83-.29-5.46,1.5-6.27,4.22l-12.78,43.11c-1.02,3.46,1.27,7.02,4.83,7.53,21.52,3.08,42.52,4.68,54.65,4.68,48.91,0,85.16-10.75,108.89-32.21,21.48-19.41,33.15-48.89,35.2-88.52V110.63c0-3.26-2.64-5.9-5.9-5.9h-56.32Zm0,64.1s.65,139.13,0,143.36c-12.08,9.77-27.11,13.59-43.49,14.7-.16,.01-.33,.03-.49,.04-1.12,.07-2.24,.1-3.36,.1-1.32,0-2.63-.03-3.94-.1-40.41-2.11-74.52-37.26-74.52-79.38,0-10.25,1.96-20.01,5.42-28.98,11.22-29.12,38.77-49.74,71.06-49.74h49.33Z"></path><path class="cls-1" d="M249.83,0C113.3,0,2,110.09,.03,246.16c-2,138.19,110.12,252.7,248.33,253.5,42.68,.25,83.79-10.19,120.3-30.03,3.56-1.93,4.11-6.83,1.08-9.51l-23.38-20.72c-4.75-4.21-11.51-5.4-17.36-2.92-25.48,10.84-53.17,16.38-81.71,16.03-111.68-1.37-201.91-94.29-200.13-205.96,1.76-110.26,92-199.41,202.67-199.41h202.69V407.41l-115-102.18c-3.72-3.31-9.42-2.66-12.42,1.31-18.46,24.44-48.53,39.64-81.93,37.34-46.33-3.2-83.87-40.5-87.34-86.81-4.15-55.24,39.63-101.52,94-101.52,49.18,0,89.68,37.85,93.91,85.95,.38,4.28,2.31,8.27,5.52,11.12l29.95,26.55c3.4,3.01,8.79,1.17,9.63-3.3,2.16-11.55,2.92-23.58,2.07-35.92-4.82-70.34-61.8-126.93-132.17-131.26-80.68-4.97-148.13,58.14-150.27,137.25-2.09,77.1,61.08,143.56,138.19,145.26,32.19,.71,62.03-9.41,86.14-26.95l150.26,133.2c6.44,5.71,16.61,1.14,16.61-7.47V9.48C499.66,4.2Line truncated
|
||||
|
After Width: | Height: | Size: 4.9 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.1 KiB |
@@ -0,0 +1 @@
|
||||
<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><defs><path d="M4.883.09v1.08a1 1 0 01-1 1H1a1 1 0 01-1-1V.09h4.883z" id="a"/><path d="M4.883.09v1.08a1 1 0 01-1 1H1a1 1 0 01-1-1V.09h4.883z" id="b"/></defs><g fill="none" fill-rule="evenodd"><path fill="#FFF" d="M99 52h84v34H99z"/><path d="M23 163c-7.398 0-13.843-4.027-17.303-10A19.886 19.886 0 003 163c0 11.046 8.954 20 20 20h20v-20H23z" fill="#3ECC5F"/><path d="M112.98 57.376L183 53V43c0-11.046-8.954-20-20-20H73l-2.5-4.33c-1.112-1.925-3.889-1.925-5 0L63 23l-2.5-4.33c-1.111-1.925-3.889-1.925-5 0L53 23l-2.5-4.33c-1.111-1.925-3.889-1.925-5 0L43 23c-.022 0-.042.003-.065.003l-4.142-4.141c-1.57-1.571-4.252-.853-4.828 1.294l-1.369 5.104-5.192-1.392c-2.148-.575-4.111 1.389-3.535 3.536l1.39 5.193-5.102 1.367c-2.148.576-2.867 3.259-1.296 4.83l4.142 4.142c0 .021-.003.042-.003.064l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 53l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 63l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 73l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 83l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 93l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 103l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 113l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 123l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 133l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 143l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 153l-4.33 2.5c-1.925 1.111-1.925 3.889 0 5L23 163c0 11.046 8.954 20 20 20h120c11.046 0 20-8.954 20-20V83l-70.02-4.376A10.645 10.645 0 01103 68c0-5.621 4.37-10.273 9.98-10.624" fill="#3ECC5F"/><path fill="#3ECC5F" d="M143 183h30v-40h-30z"/><path d="M193 158c-.219 0-.428.037-.639.064-.038-.15-.074-.301-.116-.451A5 5 0 00190.32 148a4.96 4.96 0 00-3.016 1.036 26.531 26.531 0 00-.335-.336 4.955 4.955 0 001.011-2.987 5 5 0 00-9.599-1.959c-.148-.042-.297-.077-.445-.115.027-.211.064-.42.064-.639a5 5 0 00-5-5 5 5 0 00-5 5c0 .219.037.428.064.639-.148.038-.297.073-.445.115a4.998 4.998 0 00-9.599 1.959c0 1.125.384 2.151 1.011 2.987-3.717 3.632-6.031 8.693-6.031 14.3 0 11.046 8.954 20 20 20 9.339 0 17.16-6.41 19.361-15.064.211.027.42.064.639.064a5 5 0 005-5 5 5 0 00-5-5" fill="#44D860"/><path fill="#3ECC5F" d="M153 123h30v-20h-30z"/><path d="M193 115.5a2.5 2.5 0 100-5c-.109 0-.214.019-.319.032-.02-.075-.037-.15-.058-.225a2.501 2.501 0 00-.963-4.807c-.569 0-1.088.197-1.508.518a6.653 6.653 0 00-.168-.168c.314-.417.506-.931.506-1.494a2.5 2.5 0 00-4.8-.979A9.987 9.987 0 00183 103c-5.522 0-10 4.478-10 10s4.478 10 10 10c.934 0 1.833-.138 2.69-.377a2.5 2.5 0 004.8-.979c0-.563-.192-1.077-.506-1.494.057-.055.113-.111.168-.168.42.321.939.518 1.508.518a2.5 2.5 0 00.963-4.807c.021-.074.038-.15.058-.225.105.013.21.032.319.032" fill="#44D860"/><path d="M63 55.5a2.5 2.5 0 01-2.5-2.5c0-4.136-3.364-7.5-7.5-7.5s-7.5 3.364-7.5 7.5a2.5 2.5 0 11-5 0c0-6.893 5.607-12.5 12.5-12.5S65.5 46.107 65.5 53a2.5 2.5 0 01-2.5 2.5" fill="#000"/><path d="M103 183h60c11.046 0 20-8.954 20-20V93h-60c-11.046 0-20 8.954-20 20v70z" fill="#FFFF50"/><path d="M168.02 124h-50.04a1 1 0 110-2h50.04a1 1 0 110 2m0 20h-50.04a1 1 0 110-2h50.04a1 1 0 110 2m0 20h-50.04a1 1 0 110-2h50.04a1 1 0 110 2m0-49.814h-50.04a1 1 0 110-2h50.04a1 1 0 110 2m0 19.814h-50.04a1 1 0 110-2h50.04a1 1 0 110 2m0 20h-50.04a1 1 0 110-2h50.04a1 1 0 110 2M183 61.611c-.012 0-.022-.006-.034-.005-3.09.105-4.552 3.196-5.842 5.923-1.346 2.85-2.387 4.703-4.093 4.647-1.889-.068-2.969-2.202-4.113-4.46-1.314-2.594-2.814-5.536-5.963-5.426-3.046.104-4.513 2.794-5.807 5.167-1.377 2.528-2.314 4.065-4.121 3.994-1.927-.07-2.951-1.805-4.136-3.813-1.321-2.236-2.848-4.75-5.936-4.664-2.994.103-4.465 2.385-5.763 4.4-1.373 2.13-2.335 3.428-4.165 3.351-1.973-.07-2.992-1.51-4.171-3.177-1.324-1.873-2.816-3.993-5.895-3.89-2.928.1-4.399 1.97-5.696 3.618-1.232 1.564-2.194 2.802-4.229 2.724a1 1 0 00-.072 2c3.017.101 4.545-1.8 5.872-3.487 1.177-1.496 2.193-2.787 4.193-2.855 1.926-.082 2.829 1.115 4.195 3.045 1.297 1.834 2.769 3.914 5.731 4.021 3.103.104 4.596-2.215 5.918-4.267 1.182-1.834 2.202-3.417 4.15-3.484 1.793-.067 2.769 1.35 4.145 3.681 1.297 2.197 2.766 4.686 5.787 4.796 3.125.108 4.634-2.62 5.949-5.035 1.139-2.088 2.214-4.06 4.119-4.126 1.793-.042 2.728 1.595 4.111 4.33 1.292 2.553 2.757 5.445 5.825 5.556l.169.003c3.064 0 4.518-3.075 5.805-5.794 1.139-2.41 2.217-4.68 4.067-4.773v-2z" fill="#000"/><path fill="#3ECC5F" d="M83 183h40v-40H83z"/><g transform="rotate(-15 433.487 -340.892)"><rect fill="#D8D8D8" x=".046" y=".014" width="84.522" height="33.367" rx="2"/><g transform="translate(1 20.75)" fill="#4A4A4A"><rect x="15.818" y=".339" width="4.883" height="4.883" rx="1"/><rect x="21.605" y=".339" width="4.883" height="4.883" rx="1"/><rect x="27.392" y=".339" width="4.883" height="4.883" rx="1"/><rect x="33.179" y=".339" width="4.883" height="4.883" rx="1"/><rect x="38.966" y=".339" width="4.883" height="4.883" rx="1"/><rect x="44.753" y=".339" width="4.883" height="4.883" rx="1"/><rect x="50.54" y=".339" width="4.883" height="4.883" rx="1"/><rect x="56.327Line truncated
|
||||
|
After Width: | Height: | Size: 13 KiB |
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
+203
-55
@@ -15,34 +15,177 @@ date: 2023-12-15
|
||||
|
||||
## Введение
|
||||
|
||||
[Зачем это вообще надо и кому нужен блог]
|
||||
Блог DevOps программиста (меня) – это не просто место для записей о технических деталях, это своеобразная платформа для обмена опытом, решением трудностей и создания сообщества профессионалов в области разработки и операций. Давайте разберемся, почему блог DevOps программиста может стать неотъемлемой частью вашей профессиональной деятельности.
|
||||
|
||||
### Зачем это вообще нужно?
|
||||
|
||||
#### 1. Обмен опытом
|
||||
|
||||
DevOps – это область, где опыт имеет огромное значение. Через блог вы можете делиться своими наработками, лучшими практиками и решениями, с которыми вы сталкиваетесь в ходе своей работы.
|
||||
|
||||
#### 2. Инструменты и технологии
|
||||
|
||||
В мире DevOps постоянно появляются новые инструменты и технологии. Блогирование поможет вам оставаться в курсе последних трендов, а также делиться своим опытом использования различных инструментов.
|
||||
|
||||
#### 3. Сообщество
|
||||
|
||||
Блог DevOps программиста – это место, где вы можете объединиться с другими специалистами, обсудить актуальные вопросы, получить обратную связь и даже решить технические проблемы вместе.
|
||||
|
||||
### Кому нужен блог?
|
||||
|
||||
#### 1. Стартапы и компании
|
||||
|
||||
DevOps является ключевым элементом успешного развертывания и управления IT-инфраструктурой. Ваш блог может быть полезным ресурсом для стартапов и компаний, которые стремятся оптимизировать свои процессы.
|
||||
|
||||
#### 2. Новички в сфере DevOps
|
||||
|
||||
Для тех, кто только начинает свой путь в DevOps, ваш блог станет ценным ресурсом для обучения и понимания основных принципов и практик.
|
||||
|
||||
#### 3. Специалисты по технологиям и разработке
|
||||
|
||||
Блог DevOps программиста может привлечь внимание специалистов в области технологий и разработки, помогая им лучше понять взаимосвязь между разработкой и операциями.
|
||||
|
||||
По мере продвижения в этом блоге мы рассмотрим шаги по созданию и установке вашего собственного блога DevOps программиста на вашем веб-сайте.
|
||||
|
||||
## Настройка сайта
|
||||
- <p style={{fontSize: '12px', margin: "0"}}>Если сайт уже есть, то пеерходите сразу к <a href="#установка-блога">установке блога</a></p>
|
||||
|
||||
### Покупка домена
|
||||
|
||||
[Идём на регистратор и покупаем]
|
||||
Первым шагом к созданию собственного блога является приобретение уникального доменного имени.\
|
||||
Выберите короткое, запоминающееся и отражающее суть вашего блога имя. После выбора, зарегистрируйте домен у одного из регистраторов доменных имен.\
|
||||
Лично я выбрал свой ник в качестве домена.
|
||||
|
||||
На данные момент популярны такие сервисы для регистрации доменов в РФ:
|
||||
1. [РЕГ.РУ](https://reg.ru) (за `.ru` 119/р в первый год, 999/р последующие года)
|
||||
2. [RU-CENTER (NIC)](https://nic.ru) (за `.ru` 189/р в первый год, 999/р последующие года)
|
||||
|
||||
**Для регистрации обязателен паспорт**
|
||||
|
||||
### Настройка DNS
|
||||
|
||||
[Находим бесплатный DNS сервер и писхаем туда ip]
|
||||
После приобретения домена переходите к настройке DNS. Найдите бесплатный DNS-сервер и настройте записи, указывающие на IP-адрес вашего хостинга. Это обеспечит корректное направление запросов к вашему сайту.\
|
||||
Или можно привязать к сайт [CloudFlare](https://dash.cloudflare.com/), в целом бесплатно + SSL + есть защита от аттак\
|
||||
**Так же подразумевается, что хост с белым IP уже есть.**
|
||||
|
||||
### Настройка WEB сервера
|
||||
|
||||
[Тут будет как настроить nginx на выдачу index.html + certbot]
|
||||
Теперь приступим к настройке вашего веб-сервера. В данном случае, рассмотрим пример с использованием Nginx и получением SSL-сертификата с помощью Certbot.
|
||||
|
||||
Установка Nginx:
|
||||
|
||||
```bash
|
||||
sudo apt update
|
||||
sudo apt install nginx snap
|
||||
```
|
||||
|
||||
Настройка Nginx для сайта:
|
||||
В файле конфигурации Nginx (`/etc/nginx/sites-available/default`) добавьте следующие строки:
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name santaspeen.ru;
|
||||
|
||||
root /var/www/blog/;
|
||||
index index.html;
|
||||
|
||||
location / {
|
||||
add_header Cache-Control no-cache;
|
||||
expires 0;
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# Media: images, icons, video, audio, HTC
|
||||
location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|svgz|mp4|mp3|ogg|ogv|webm|htc)$ {
|
||||
expires 1M;
|
||||
access_log off;
|
||||
add_header Cache-Control "public";
|
||||
}
|
||||
|
||||
# Javascript and CSS files
|
||||
location ~* \.(?:css|js)$ {
|
||||
expires 1y;
|
||||
access_log off;
|
||||
add_header Cache-Control "public";
|
||||
try_files $uri =404;
|
||||
}
|
||||
|
||||
# Any route containing a file extension (e.g. /devicesfile.js)
|
||||
location ~ ^.+\..+$ {
|
||||
try_files $uri =404;
|
||||
}
|
||||
}
|
||||
```
|
||||
Не забудьте изменить `santaspeen.ru` и `/var/www/blog/` под свои данные.
|
||||
|
||||
:::tip
|
||||
Если не использовать cloudflare, то SSL аертификаты нужно получить на хосте\
|
||||
Установим Certbot для получения SSL-сертификата:
|
||||
|
||||
```bash
|
||||
sudo snap install --classic certbot
|
||||
sudo ln -s /snap/bin/certbot /usr/bin/certbot
|
||||
```
|
||||
|
||||
С помощью этой комнды автоматически будет настроено SSL шифрование трафика\
|
||||
`certbot` спросит все нужные ему данные: домен, почту и т.д.
|
||||
```bash
|
||||
sudo certbot --nginx
|
||||
```
|
||||
|
||||
:::
|
||||
|
||||
Теперь, после всего что мы сделали, У нас будет доступ по https: https://santaspeen.ru/
|
||||
|
||||
|
||||
## Установка блога
|
||||
|
||||
:::tip
|
||||
Настройку / Написание текста / Проверку - советую делать на компе, а затем после `npm build` загружать на хостинг.
|
||||
:::
|
||||
|
||||
### Качаем
|
||||
### Загрузка
|
||||
|
||||
[тут гит клон]
|
||||
Давайте начнем с загрузки необходимых файлов для вашего блога. Вы можете воспользоваться командой git clone для получения исходного кода блога:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/SantaSpeen/santaspeen.ru-blog.git
|
||||
```
|
||||
|
||||
### Установка зависимостей
|
||||
|
||||
Убедитесь, что вы используете Node.js версии 20. Вы можете загрузить и установить ее с официального сайта Node.js: [Node20](https://nodejs.org/download/release/latest-v20.x/)
|
||||
Перейдите в директорию вашего блога и выполните команду `npm install`, чтобы установить все необходимые зависимости:
|
||||
|
||||
```bash
|
||||
cd santaspeen.ru-blog
|
||||
npm install
|
||||
```
|
||||
|
||||
### Запуск
|
||||
|
||||
1. **Настройка статических файлов:**
|
||||
- Проверьте и отредактируйте файлы в папке `static`:
|
||||
- `static/CNAME`: Укажите ваш домен в этом файле.
|
||||
- `static/robots.txt`: При необходимости настройте файл robots.txt.
|
||||
- `static/img/favicon.ico`: Замените иконку на свою.
|
||||
|
||||
2. **Настройка переменных окружения:**
|
||||
- Отредактируйте файл `.env`, указав необходимые параметры.
|
||||
|
||||
3. **Настройка конфигурации:**
|
||||
- При необходимости внесите изменения в файл `.aligoria_config.json` в соответствии с вашими предпочтениями.
|
||||
|
||||
4. **Запуск:**
|
||||
- Выполните команду `npm start` для запуска дебаг сервер блогом (при редактировании файлов, содержимое сразу будет обновлено и на сайте).
|
||||
|
||||
## Настройка блога
|
||||
|
||||
### Общая структура
|
||||
|
||||
Вот так сейчас выглядит структура файлов блога:
|
||||
Вот так сейчас выглядит структура файлов блога и доков:
|
||||
|
||||
```plain
|
||||
...
|
||||
| -- blog
|
||||
@@ -62,13 +205,18 @@ date: 2023-12-15
|
||||
...
|
||||
```
|
||||
|
||||
[Тут надо рассказать про основные файлы]
|
||||
### Основные файлы
|
||||
|
||||
- **`blog/_template/index.md`:** Главная страница блога.
|
||||
- **`blog/_template/logo.png`:** Логотип блога.
|
||||
- **`docs/_template/_category_.json`:** Файл категории для организации документации.
|
||||
- **`docs/_template/doc1.md` и `docs/_template/doc2.md`:** Примеры документации.
|
||||
- **`docs/intro.md`:** Введение в документацию.
|
||||
|
||||
### Cтруктура блогов
|
||||
|
||||
[Несколько слов про то, или инное, рассмотрим на примере blog._template]
|
||||
Приведем пример для блога `_template`:
|
||||
|
||||
[Стандартная структура 1 блога]
|
||||
```plain
|
||||
| -- blog
|
||||
| ` -- _template
|
||||
@@ -76,12 +224,13 @@ date: 2023-12-15
|
||||
| ` -- logo.png
|
||||
```
|
||||
|
||||
##### Заголовок у блога
|
||||
##### Пример заголовка блога (`blog/_template/index.md`):
|
||||
|
||||
```md
|
||||
---
|
||||
slug: template
|
||||
title: title
|
||||
description: Описание
|
||||
title: Заголовок блога
|
||||
description: Описание блога
|
||||
image: ./logo.png
|
||||
tags: [docker, linux, networks]
|
||||
keywords: [docker, linux]
|
||||
@@ -90,26 +239,25 @@ date: 2023-11-29
|
||||
|
||||
Описание для предварительного просмотра на главной странице
|
||||
|
||||
[](/blog/_template)
|
||||
[](/blog/_template)
|
||||
<!--truncate-->
|
||||
|
||||
Этот текст будет только в блоге, его не видно в превью
|
||||
```
|
||||
|
||||
`slug` - [Это..]\
|
||||
`title` - [Это..]\
|
||||
`description` - [Это..]\
|
||||
`image` - [Это..]\
|
||||
`keywords` - [Это..]\
|
||||
`date` - [Это...]\
|
||||
\
|
||||
`<!--truncate-->` - [Это...]
|
||||
- `slug`: уникальный идентификатор блога.
|
||||
- `title`: заголовок блога.
|
||||
- `description`: описание блога.
|
||||
- `image`: путь к логотипу блога.
|
||||
- `tags`: теги блога.
|
||||
- `keywords`: ключевые слова для поисковых систем.
|
||||
- `date`: дата публикации блога.
|
||||
- `<!--truncate-->`: разделитель для превью.
|
||||
|
||||
### Структура документации
|
||||
|
||||
### Структура доков
|
||||
Приведем пример для документации `_template`:
|
||||
|
||||
[Несколько слов про то, или инное, рассмотрим на примере docs._template]
|
||||
|
||||
|
||||
[Стандартная структура 1 дока]
|
||||
```plain
|
||||
| -- docs
|
||||
| | -- _template
|
||||
@@ -119,51 +267,41 @@ date: 2023-11-29
|
||||
| ` -- intro.md
|
||||
```
|
||||
|
||||
[_category_.json Обязателен, рассказать что в нём]
|
||||
##### Содержимое `_category_.json` в `docs/_template/_category_.json`:
|
||||
|
||||
Содержимое \<theme>/_category_.json
|
||||
```json
|
||||
{
|
||||
"label": "Template",
|
||||
"position": 1,
|
||||
"link": {
|
||||
"type": "generated-index",
|
||||
"description": "Template description"
|
||||
"description": "Описание шаблона"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`label` - [Это..]\
|
||||
`position` - [Это..]\
|
||||
`link` - [Это..]\
|
||||
`link.type` - [Это..]\
|
||||
`link.description` - []
|
||||
- `label`: название категории.
|
||||
- `position`: позиция в навигации.
|
||||
- `link.type`: тип ссылки (здесь генерируется индекс).
|
||||
- `link.description`: описание ссылки.
|
||||
|
||||
##### Заголовок у доков
|
||||
[У каждого файла должен быть заголовок... Зачем? Почему?]
|
||||
##### Пример заголовка документа (`docs/_template/doc1.md`):
|
||||
|
||||
Заголовок doc1.md
|
||||
```md
|
||||
---
|
||||
sidebar_position: 1
|
||||
title: Template title 1
|
||||
title: Заголовок документа 1
|
||||
---
|
||||
|
||||
Template text
|
||||
Текст документа
|
||||
```
|
||||
|
||||
в doc2.md соответсвенно будет
|
||||
```md
|
||||
---
|
||||
sidebar_position: 2
|
||||
title: Template title 2
|
||||
---
|
||||
- `sidebar_position`: позиция в боковой панели.
|
||||
- `title`: заголовок документа.
|
||||
|
||||
Template text
|
||||
```
|
||||
Аналогично, для `doc2.md` будет другой `sidebar_position` и `title`.
|
||||
|
||||
`sidebar_position` - [Это..]\
|
||||
`title` - [Это...]
|
||||
При настройке блога и документации учтите указанные параметры для создания структуры и корректного отображения контента.
|
||||
|
||||
### Настройка стилей
|
||||
|
||||
@@ -173,10 +311,11 @@ Template text
|
||||
|
||||
```css
|
||||
/* src/css/custom.css */
|
||||
|
||||
:root {
|
||||
--footer-padding: 0.5em;
|
||||
}
|
||||
|
||||
/* For readability concerns, you should choose a lighter palette in dark mode. */
|
||||
[data-theme='light'] {
|
||||
--ifm-color-primary: #7c538bfd;
|
||||
--ifm-color-primary-dark: #21af90;
|
||||
@@ -189,6 +328,7 @@ Template text
|
||||
--footer-color: #000;
|
||||
--docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
|
||||
}
|
||||
|
||||
[data-theme='dark'] {
|
||||
--ifm-color-primary: #c4c0c5fd;
|
||||
--ifm-color-primary-dark: #21af90;
|
||||
@@ -201,26 +341,34 @@ Template text
|
||||
--footer-color: #ebedf0;
|
||||
--docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
|
||||
}
|
||||
|
||||
.footer {
|
||||
--ifm-footer-background-color: var(--footer-background-color);
|
||||
--ifm-footer-color: var(--footer-color);
|
||||
padding: var(--footer-padding)
|
||||
}
|
||||
|
||||
.header-github-link:hover {
|
||||
opacity: 0.6;
|
||||
}
|
||||
|
||||
.header-github-link::before {
|
||||
content: '';
|
||||
width: 24px;
|
||||
height: 24px;
|
||||
display: flex;
|
||||
}
|
||||
|
||||
[data-theme='light'] .header-github-link {
|
||||
background: url("/img/github.svg") 0 center / 25px 25px no-repeat;
|
||||
}
|
||||
h2 {
|
||||
--ifm-heading-vertical-rhythm-bottom: 0;
|
||||
|
||||
[data-theme='dark'] .header-github-link {
|
||||
background: url("/img/githubL.svg") 0 center / 25px 25px no-repeat;
|
||||
}
|
||||
p a {
|
||||
|
||||
.markdown li a, .markdown p a {
|
||||
text-decoration: underline dotted;
|
||||
}
|
||||
```
|
||||
|
||||
```
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 196 KiB After Width: | Height: | Size: 175 KiB |
Reference in new issue
Block a user