Onboarding или инструкция к блогу

Инструкция о том, как получить максимальную пользую от блога.

· 3 минуты на чтение

Меня зовут Марк. И это мой блог, который посвящен преимущественно Java разработке и прочим подобным темам.

Подробнее познакомиться со мной и моим опытом можно на отдельной странице. А тут вы узнаете, как устроен и систематизирован мой блог, чтобы получить от него максимум пользы. Своего рода инструкция по использованию.

История возникновения и миссия

В какой-то момент у меня появилось непреодолимое желание писать. А так как я умею в разработку, то решил, что самое время завести блог по программированию. Это мой основной блог, на него уходит большая часть творческих ресурсов.

Кто-то ведет бумажные заметки, сохраняя что-то полезное, кто-то собирает все в word файлы. Это отличные способы, но я решил что свой сайт это вызов. Тогда я еше ничего толком не знал о том, как устроены сайты, о nginx, и прочем. Поэтому это было также позновательно, и дало мне некоторые полезные навыки.

Миссия моего блога довольно проста. Во первых, я сам иногда узнаю что-то новое, пока готовлю статью. Также мне приятно делиться своими знаниями с другими людьми.

Команда авторов

На данный момент я пишу статьи самостоятельно, и статьи от других авторов скорее исключение, нежели правило. Но в моей душе теплится надежда, что когда-нибудь я найду единомышленников, которые присоединятся ко мне.

Если вы хотите публиковаться от своего имени на моем сайте, то напишите мне. Можем обсудить любые варианты, вдруг вы хотите писать про Python или Go. Все обсуждаемо, почти все решаемо 😉

Про переводы статей

На моем сайте вы также можете найти переводы статей англоязычных разработчиков. Все такие статьи имеют ссылки на первоисточник. Также у каждого автора есть своя страница на моем сайте, но об этом читайте ниже в разделе "Навигация".

Я не вижу ничего плохого в переводах, поэтому если у вас есть желание переводить мои статьи на свой язык, то вперед. Главное укажите ссылку на первоисточник.

Однако, я не просто занимаюсь адаптацией и переводом этих статей, но также проверяю примеры кода, оформляю их в отдельный репозиторий, который вы можете склонировать.

Также я могу отойти от дословного перевода и добавить какую-то информацию от себя. Также я стараюсь держать все статьи в актуальном состоянии, поэтмоу если статья была написана давно, то я обновлю используемые там библиотеки и прочие вещи.

Навигация и систематизация

Теперь расскажу про систему навигации и систематизации статей, чтобы вы могли найти только то что интересует вас, и то что подходит для вашего уровня погружения.

📥
Узнавайте о новых статьях подписавшись на мой канал в Telegram или на RSS ленту.

Поиск

На сайте поддерживается поиск, но он имеет технические ограничения. Поиск выполняется по названиям, тегам, авторам и короткому поиску. К сожалению, полный поиск по тексту статей на данный момент не поддерживается в Ghost CMS.

Однако, можно воспользоваться поиском Google или Yandex с параметром. Просто добавьте в свой поисковый запрос site:struchkov.dev, и это позволит найти произвести полнотекстовой поиск по статьям сайта.

Пример выполнения такого запроса

Теги

Для систематизации статей используются теги. Все теги можно посмотреть на отдельной странице, сейчас я расскажу об основных тегах.

Каждая статья получает один или несколько из главных тегов, назовем их разделом/категорией, это может быть:

  • Обзор. Здесь поверхностные обзоры новых технологий, этакие Hello World.
  • Заметка. Короткие, но полезные записи. Не тянут на полноценный гайдлайн, и никаких обязательств по поддержанию в актуальном состоянии от меня.
  • Snippet. Это какой-то полезный кусок кода, который я сохранил для себя, и который я захотел с кем-то расшарить. Там может не быть объяснений.
  • Гайдлайн. Полноценный разбор какой-то темы или проблемы. Такие статьи обычно обновляются раз в полгода/год. Проверяется их актуальность, актуализируются используемые технологии и прочее.
  • Серия. Связанная серия статей из гайдлайнов, которая охватывает несколько сложных аспектов темы.
  • Проект. Это статьи о моих пет-проектах, в которых я делюсь подробностями реализации.
  • Перевод. Сюда попадают все переведенные мной статьи. Подробнее о переводах ниже.

Также практически все статьи получают тег сложности. Задумка такая: если вы Junior, то вам интересно будет читать статьи из раздела Junior, а если Middle, то из раздела Middle. Джуну может быть сложно воспринимать статьи из раздела Middle.

Вот существующие уровни сложности на данный момент:

Также есть более узконаправленные теги, например если в статье идет речь о Java с использованием фремворка Spring и Hibernate, то статья получит следующие теги: java, spring, hibernate. Таким образом можно находить статьи по определенным темам.

Фильтры

Также некоторые теги для удобства можно группировать. Таким образом получаются фильтры.

Например у меня есть куча статей по Java для уровня Junior. Вы можете посмотреть все статьи по Java или все по Junior, но было бы удобно находить только статьи Java и только для Junior. Для этого и существуют фильтры.

На данный момент доступны следующие фильтры:

Сортировки

Все статьи на сайте можно отсортировать, если перейти по определенному адресу.

Доступные сортировки:

Резюмирую

Здесь вы ознакомились со способом структуризации статей, теперь вы можете отфильтровать и отсортировать посты по нужным доступным параметрам. К сожалению, на Ghost CMS невозможно реализовать динамическую фильтрацию.

Также вы можете воспользоваться поиском, который позволяет искать по тегам, авторам и короткому описанию статей.

На этом у менся все, надеюсь мой сайт окажется для вас полезным. Если у вас будут идеи по улучшению навигации, или улучшению статей, то не стесняйтесь оставлять комментарии.

Struchkov Mark
Struchkov Mark
Задавайте вопросы, если что-то осталось не понятным👇