В далеком воспоминании я набрал какой-то текст, нажал «Отправить» и получил запись в блоге. Несмотря на простоту, ему не хватало изящества; статьям не хватало блеска. С каждой статьей я корректировал свой процесс, свой сайт и свои инструменты. Позвольте мне дать вам обзор того, как это выглядит сейчас, от идей, уценки и HTML до публикации и продвижения.

Если вас не слишком интересуют технические подробности, прокрутите вниз до «Вычитка» или «Публикация».

Тема и текст

Придумывать тему — это все равно, что выщипывать перья у чокнутой курицы: так много всего на выбор, некоторые легко поймать, другие неуловимы, некоторые красивы, а третьи уродливы. Сочетание того, что я хочу написать, того, что я хочу написать, и того, что, по моему мнению, людям интересно читать, выбор никогда не бывает однозначным. Давайте просто предположим, что темы волшебным образом всплывают из трясины.

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

Они называют мою цветовую тему «Turbo C Garish».

Как и в случае с программированием, я использую пропорциональный шрифт и разрешаю перенос строк.

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

Форматирование уценки

Я выбрал уценку, так как она минимально влияет на текст. У него мало накладных расходов и ограниченный синтаксический беспорядок. Однако он мало что дает в плане форматирования.

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

Я использую настраиваемый процессор уценки, чтобы преобразовать свой текст в HTML-код, который принимает WordPress, моя основная платформа. Процессор написан на Python с библиотекой markdown. Это не очень приятный модуль; трудно изменить форматирование и плохо справляется с расширениями. Я смирился с этим как с приемлемым решением на данный момент.

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

Латекс

Многие из моих статей используют формулы и выигрывают от правильного математического форматирования. Хотя я считаю Latex ужасным языком, он поддерживает любое уравнение, которое мне может понадобиться. Расширение доллара + обратная кавычка позволяет мне встроить латекс.

Для тестирования мой процессор создаст файлы PNG, используя последовательность texi2dvi, dvips и convert. Это позволяет мне просматривать страницы локально с уравнениями. При экспорте в HTML используется встроенная латексная нотация WordPress.

Прежде чем я снова изменю внешний вид своего сайта, мне нужно будет самостоятельно обработать Latex на WordPress. Предлагаемые темы делают ужасную работу, чтобы сделать это правильно. Я был вынужден быстро отказаться от предыдущего изменения темы, так как ни один из моих латексных материалов не отформатировался правильно. Однако для самостоятельного создания изображений с уравнениями необходимо просмотреть все старые статьи и обновить их!

MyFencedCode

Мне не понравилось форматирование блоков кода по умолчанию. Он не предлагал никакого способа его изменить; Я скопировал код и внес изменения, чтобы создать другое форматирование, подходящее для моего сайта. Я изменил как сгенерированную структуру HTML, так и параметры, переданные в расширение codehilite.

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

У меня есть средство форматирования pygments для Leaf. Это вписывается в обычную цепочку инструментов для подсветки синтаксиса.

Центр и реклама

Для изображений у меня есть процессор >>, который центрирует абзац. Раньше я использовал его для формул латекса, но с тех пор изменил его, чтобы автоматически центрировать их самостоятельно. Теперь я должен использовать его для изображений, но я склонен позже вставлять их в визуальный редактор в WordPress. Сейчас я планирую сделать это «правильно», загрузив сначала и добавив ссылку на изображение в уценке.

Последний рекламный ролик в каждой статье — это блок >B>, который создает тег aside в HTML. Если вы читаете эту статью на другом сайте, например на dev.to, вы можете их не увидеть; Я иногда удаляю рекламные объявления при кросспостинге.

Вычитка

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

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

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

Давным-давно мой друг редактировал мои статьи, но это отнимало слишком много времени. Я хотел бы снова иметь редактора-человека.

Издательский

После проверки я провожу визуальную проверку на месте. Как уже упоминалось, процессор уценки может производить локальный тест. Он изменяет несколько элементов, а также добавляет CSS к сгенерированному HTML (тот же CSS, который я использую на веб-сайте). Я могу открыть этот файл локально и получить хорошее представление о том, как он будет выглядеть на mortoray.com.

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

Сейчас самое время щелкнуть правой кнопкой мыши все ссылки, чтобы убедиться, что они верны.

Когда все готово, я генерирую окончательный HTML-код. Я просматриваю этот Firefox еще раз, чтобы убедиться, что он работает — поскольку предыдущий файл уже есть, мне просто нужно перезагрузить его. Я нажимаю Ctrl+U, чтобы просмотреть исходный код, скопировать и вставить его в WordPress.

Теперь немного возни с деталями: переместите заголовок в специальное поле, выберите категорию, добавьте несколько тегов, выберите аннотацию в социальных сетях (к которой я добавляю хэштеги). Также требуется избранное изображение; Я склонен смотреть на pixabay для них.

Нажимаем «Опубликовать» и готово…

Кросс-постинг

Увы, мой сайт не является нарицательным (пока), и, несмотря на приличное количество подписчиков, публикации только на моем сайте и в социальных сетях не уделяют моим статьям большого внимания. Могло бы, и иногда мне это удается, но здесь замешано огромное количество удачи. В какой-то момент я собирался написать статью об интернет-лотерее.

Мои чтения увеличиваются за счет кросс-постинга. Где я публикую изменения с течением времени; Я постоянно ищу качественные возможности. Я не хочу спамить повсюду и не хочу низкой отдачи (это требует усилий).

В настоящее время я размещаю почти все свои статьи на dev.to. Я использую источник уценки, но нужно внести некоторые изменения. Если уравнений слишком много, я могу не делать кросс-пост, так как это требует слишком много ручной работы по захвату ссылок на изображения с моего сайта. Если бы я уже переключился на создание собственных латексных изображений, это не было бы проблемой.

Многие мои статьи также попадают в Медиум. У них есть функция импорта, но она ужасна для исходного кода. Я не буду публиковать там статьи с большим количеством кода.

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

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

Блестящее новое яйцо

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

И если вы думаете о создании блога, я предлагаю сначала сделать его простым. Я не садился и не создавал все свои инструменты сразу, не выбирал свой стиль за одну ночь и не сразу занимался каждой технической деталью. Как и во всем, это постоянно развивающаяся работа. Скорее всего, я что-то изменю еще до того, как нажму «Отправить» в этой статье.

Если вам нравится то, что я пишу, подпишитесь на меня в Twitter или Facebook, или, чтобы не пропустить меня, станьте покровителем. Спасибо, что прочитали.

Первоначально опубликовано на сайте mortoray.com 6 апреля 2018 г.