Как вы пишете статьи?

Question

[IceStriker]

Всем доброго дня!
Давно хочу написать сборник статей или даже небольшую электронную книгу на тему "RESTful api + SPA с самого начала"
Но не знаю где удобнее писать, чтобы вставки кода были подсвечены, форматирование, приятные шрифты и прочее..

Как вариант запилить блог с блекджеком и подсветкой на коленке, либо https://www.gitbook.com / https://evernote.com и тп

Может кто сможет подсказать еще варианты? Где было бы удобно писать черновики по it тематике

p.s. если кому интересна связка, то это Symfony 3 + Angular 2 приправленная right way и прочими ништяками)

Comments

[numfin]

оставь плз ссылку, где можно будет узнать о выходе статей

[Егор Живагин]

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

[IceStriker]

numfin Егор Живагин как первую часть закончу и определюсь где публиковать - отпишусь в этой теме)
Упомяну всех кто заинтересован

[riot26]

IceStriker: я в очереди :)

[numfin]

IceStriker: все ещё жду

[Владимир Проскурин]

Я тоже в очереди

Answer 1

[Николай Шабалин]

Сам пишу в gitbook. Удобно, что markdown. Можно дополнять плагинчиками.
Вот здесь допустим, можно сохранять в PDF, ePub, Mobi.

Еще были примеры с пошаговым чтением и с сохранением прочитаного, как здесь

Comments

[Ipeacocks]

можно еще глянуть на https://typora.io/
он пока-что еще бесплатен.

[IceStriker]

Ipeacocks за https://typora.io/ благодарствую, для черновиков думаю в самый раз сгодится, чтобы потом уже публиковать где-либо

Надеюсь они совместимы с гитбуком между собой.

Answer 2

[TomasHuk]

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

Comments

[IceStriker]

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

s00.yaplakal.com/pics/pics_original/4/4/4/282444.jpg

p.s. хотя выйти с циклом статей на хабр очень даже заманчиво)

[Вова Дружаев]

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

[AnjeyTsibylskij]

Владимир Дружаев: и что с этого, что сольют или минусов накидают? Хабр - это *просто* сайт. Кому-то не понравилось, слили карму, ну и хрен с ней, пошли дальше! Это же не конец жизни, верно?

[Вова Дружаев]

AnjeyTsibylskij: чувак - а после такого плевка писать будет желание? Даже если все ошибки учтены. Но факт хабра (текущего, а не ранее) что многое делают втихаря. Просто минусуют, не указывая в чем проблема. Так что лучше на Медиум опубликовать.

Answer 3

[Eugene Burmakin]

Gitbook, leanpub

Comments

[IceStriker]

Насколько я понял leanpub это коммерческий gitbook своего рода? По функционалу один в один

[Eugene Burmakin]

IceStriker: вроде того, там сразу и маркетплейс, и удобная система выплат, и конвертер в три популярных формата

[IceStriker]

эм.. "Your price to create a new book has been set by Leanpub to be $99.00. Thanks for supporting Leanpub"

они берут процент с продаж + стартовый взнос 100 баксов? :)

[Eugene Burmakin]

IceStriker: да, создать книгу стоит 100 долларов, плюс процент от продаж (10% + $0.5). Перевод созданной книги стоит нето 10 нето 20 долларов создать

Answer 4

[lukoie]

do search alternativeto Scrivener

Comments

[lukoie]

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

[IceStriker]

Благодарю, за советы!
Насколько я понял википэд это wikidpad.sourceforge.net ?
Я работаю на никсах, так что Scrivener нашел только неоффициальный, погляжу что за зверь. Если заработает, пойму какие именно альтернативы искать)
Насчет книжонки, обязательно дам знать, сейчас бы только на подготовительном этапе настрой не растерять :)

[lukoie]

да, это он.
поглядите еще для общего развития paper.dropbox.com

[lukoie]

о, вспомнил одну приблуду. может вот так лучшей? www.mkdocs.org

[lukoie]

а вот пример, из которого я когда то про нее и узнал: docs.nwjs.io/en/latest

[IceStriker]

lukoie paper вчера поглядел, довольно занятно, но очень сыро, а импорт вообще просто швах (
сейчас остальные ссылки посмотрю)

кстати очень понравилась связка typora + dropbox синхронизация, а то рабочий ноут на никсах, а домашний пк под виндой.

[lukoie]

IceStriker: ну если архитектура пейпера видится занятной, то Вам видимо нужно в Quip, я им постоянно пользуюсь. Мне правда кажется что для Вашей поставленной задачи оно немного не совсем то. Но кто знает. Я в нем веду записи на хакатонах, и как глава ОСМД там веду всякую важную фигню.
Но вот для книжки оно не так чтобы очень.
Скажу по правде, я и сам еще не нашел идеального инструмента. Но у меня немного другая задача - двуязычная. Перевод с комментариями евангелий(с греческого на русский) и Корана(с арабского на русский).

[lukoie]

IceStriker: удобно выглядит: getjump.me/ru-php-the-right-way
можно просто форкнуть: https://github.com/getjump/ru-php-the-right-way
понравилось решение - поддиректорию своего домена на гитхабпейджес. стильно и со вкусом,а главное бесплатно

[IceStriker]

lukoie достойный вариант, еще движок найти на котором learn.javascript.ru/promise крутится, там тоже все на md файлах основано

Answer 5

[ummahusla]

Medium

Comments

[IceStriker]

Интересный вариант, но нет подсветки кода. Хотя как паблишер, может и зайдет, своя аудитория в комплекте)

[ummahusla]

IceStriker: все через github gist добавляют код обычно. Немного геморроя но все же, стоит того

[IceStriker]

Спасибо за замечание, увидел результат вставки гиста. Очень даже неплохо)
Для написания черновиков надо пробовать в деле, а вот публикация там бесспорно, хотя на русском контента почти не нашел

[ummahusla]

IceStriker: ну я почти не читаю русский контент кроме харба и цукербергпозвонит. А сам я веду свой блог и иногде репосты на медиум делаю, но много просмотров они не приносят

[IceStriker]

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

Answer 6

[Павел Радьков]

Меня неожиданно и приятно удивил Dropbox Paper. Там есть Markdown, подсветка кода, to do lists с галочками.
Для черновиков очень подходит: автосохранение, доступ даже с мобильного, не нужно задумываться о коммитах, минималистичный интерфейс как у meduim, возможность поделиться документом и обсудить.

https://paper.dropbox.com/

Ну а потом для финальной публикации, вычитки и поддержки — gitbook или что-то своё.

Comments

[GTRxShock]

Штука несомненно крутая, но сырая на мой взгляд. Особенно беда с импортом. Вся markdown разметка теряется.

Answer 7

[xmoonlight]

Всё просто, варианта 2:
1. Хотите предоставить управление Вашими данными (публикациями) 2-й стороне - пишите где угодно, но помните, что принятое Вами соглашение возможно будет изменено в одностороннем порядке!
Т.е., Вы дарите свой труд согласно соглашению.
2. Создаёте свой сайт, ставите CMS, например CMS Joomla!, создаёте шаблон и подсветку кода и пишите там: Вы сам себе хозяин и у Вас полное управление!

Оптимальный для самопиара: Если контент не особо ценный + хочется стабильно и бесплатно + хорошее автоматическое SEO - лучше использовать blogger.com (Блоги Google), т.к. гугл свои сервисы всегда ставит выше других.
Лично я - пишу там: https://sitecoder.blogspot.ru/

Comments

[IceStriker]

Несколько не по теме, но, если не секрет, профит с блога есть?

[xmoonlight]

IceStriker: только как PR-площадка.

[Ильяс Якубов]

IceStriker: данную тематику сложно монетизировать. Тупо с банеров будут копейки. Пример: блог с 80 тыс. уникальных посетителей в месяц и 150 тыс. просмотров страниц приносит ~30$ с adsense
P.S. В качестве платформы для блога больше подходит wordpress, а не Joomla!.

[IceStriker]

Ильяс Якубов благодарю за информацию! Случаем не подскажете, почему именно wp? (хотя для блога я альтернатив и не вижу) Чисто из научного интереса, на тот случай если буду выбирать между wp и самописным блогом на angular 2 с серверным рендерингом)

[Ильяс Якубов]

IceStriker: у WP элегантная простая и прозрачная архитектура движка, неограниченные возможности качтомизации, но при этом очень низкий порог входа для diy. Сам я начинал с Joomla!, которая привлекла меня якобы большой свободой кастомизации и большим количеством опций из коробки, а на деле оказалась жутко неудобной и непродуманной.
По поводу самописных движков ничего не могу сказать, т.к. даже не задумывался о таком пути. Но кмк все же эффективнее использовать готовый движок.

[riot26]

Ильяс Якубов: куча глобальных переменных, куча функций с дебильными именами, отсутствие ООП в движке, невозможность нормально наследоваться от тем -- это элегантная архитектура?

[Ильяс Якубов]

riot26: не критикуй, предлогай! (ц) Какая альтернатива?

[riot26]

Ильяс Якубов: смотря для чего. Мне нравится OctoberCMS

[Ильяс Якубов]

riot26: вот именно! Смотря для чего! Для блога лучше wp!

[xmoonlight]

Ильяс Якубов: про жумлу: уточните с какой версии начинали и "на деле оказалась жутко неудобной и непродуманной" - при использовании какой версии?

[Ильяс Якубов]

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

[riot26]

Ильяс Якубов: аллах упаси работать с такой кучей легаси. Есть же Ghost, Medium, Bolt, Jekyll и ещё куча подходящих.

[xmoonlight]

Ильяс Якубов: я для себя просто хотел узнать (может я что не заметил): что конкретно не устраивает в их подходе?
Вот, лично меня, на данный момент - всё там устраивает. (поэтому и пытаюсь понять...)

[Ильяс Якубов]

xmoonlight: на тот момент меня не устраивала избыточная кмк этапность настройки и именно что отсутствие простоты. Очень (повторю: очень) грубая аналогия: wp=ios, joomla=android_первых_версий. Мне в wp нравится, что для запуска блога нужно всего 5 минут, но спустя время ты можешь усложнить/изменить проект до неузнаваемости.

[Ильяс Якубов]

riot26: пройдет время и все вышеперечисленное тоже обрастет легаси ;) Да хранит вас Аллах!

[riot26]

Ильяс Якубов: worpress может обогнать только ядро линукса. Там чешутся менять код только когда в новых версиях PHP какие-то фичи уже deprecated. И об ООП они походу не слышали.

[xmoonlight]

Ильяс Якубов: https://www.joomla.org/3/ - с верхней ссылки в правом баре (и т.д. вниз или нажимая "< PREV")