Как добавлять и вносить правки

Как добавлять заметки и вносить правки

Главное помнить: исходники в Markdown и наш сайт автоматически подцепляет и форматирует их за счёт Jekyll.

Для того чтобы править, например, эту страницу, попробуйте найти небольшую пиктограмму “Edit on Github” рядом с заголовком, и перейти на исходный код в репозитории.

Внимание, следующий по странице объект - не рекурсия, а фото экрана этой же страницы.

Редактирование осуществляется c помошью отправки Merge запроса, см. инструкции для генератора Jekyll.

Тема оформления

Сайт работает на dark теме TeXt-theme. Много что в ней изменяемо, шлите предложения.

Конвенции

Записи

Файлы должны иметь вид YYYY-MM-DD-lower-train-case.md, это требуется для чтения даты при генерировании.

Читайте более подробно в Writing Posts и в adding content.

Файлы (например картинки)

• Используйте Pixlr или любой другой онлайн-редактор для коррекций больших размеров изображений
• Используйте TinyPng или любой другой компрессор для улучшения степени сжатия файлов
• Файлы должны храниться в папке src/posts_images и иметь вид YYYY-MM-DD_snake_case.ext
• В Markdown должны иметь site.baseurl в адресе, перед /posts_images/, например:

![Иллюстрация №1]({{ site.baseurl }}/posts_images/2025-04-27_01.png){: width="500" }

• Да, Jekyll поддерживает аттрибуты СSS для изображений, наподобие {: width="500" } в примере выше

Уточнение

На самом деле без разницы snake_case или Train-case главное сохраняйте YYYY-MM-DD в начале файлов.

Локальная копия

Для правок и новых страниц можно склонировать весь репозиторий и затем править его локально, на порту 4000, используя bundle exec jekyll serve как разъясняется в примере quick start

Вам не требуется локальная копия чтобы создавать новые заметки или вносить правки

Это не самый элегантный но наиболее простой на данный момент способ всем вносить правки.

Отправляйте PR-ы.

Новые страницы можно добавлять по образу и подобию в src/_posts/.