Хороший редактор технических руководств на Mac?

Я пишу много руководств и публикую их в формате HTML. Обычно я набираю их непосредственно в HTML, но каждый раз, когда я использую <code>теги для демонстрации примера кода, мне приходится вручную обновлять содержимое тегов (например, меняя >на &gt;).

В настоящее время я использую TextMate 2, но ищу более эффективный способ сделать это на Mac. Как бы вы подошли к этому (уценка?) и какое программное обеспечение вы бы использовали?

Спасибо!

Вам нужен импорт/экспорт в/из формата HTML?
Экспорт в HTML, да. Согласно моему ответу, Моу делает это отлично.

Ответы (6)

Я бы порекомендовал вам ReText , как указано в моем ответе здесь :

Ретекст с предварительным просмотром в реальном времени
ReText с предварительным просмотром в реальном времени (источник: ReText; щелкните изображение, чтобы увеличить его)

  • Он доступен для OSX
  • Он имеет предварительный просмотр в реальном времени, поэтому вы видите результаты того, что вы печатаете, пока печатаете.
  • Он поддерживает множество диалектов и других дополнений, таких как «codelite» для подсветки кода.
  • Не возитесь с HTML (за исключением случаев, когда вы этого хотите), но используйте Markdown (как здесь, в SE)
  • Он может экспортировать ваши тексты в формате HTML, ODT (Open Document Text, т.е. для OpenOffice/LibreOffice), PDF

Я сам пользуюсь им некоторое время и вполне им доволен: плавный и стабильный.

Я бы предложил использовать редактирование вашего документа в реструктурированном тексте, rst , и использовать такой инструмент, как pandoc , для создания окончательной версии (версий).

Это позволит вам свести к минимуму ваши рабочие файлы в удобном формате, подходящем для управления версиями, при выводе вывода в любом или во всех: asciidoc, beamer, context, docbook, docx, dzslides, epub, epub3, fb2, html, html5, json, латекс, мужчина, уценка, markdown_github, markdown_mmd, markdown_phpextra, markdown_strict, mediawiki, родной, odt, opendocument, opml, org, pdf*, простой, покажите js, рст, rtf, s5, слайдоус, скользкий, texinfo, текстиль.

AsciiDoc

Доктор Мэтт Нойбург , один из лучших ныне живущих технических писателей, создает огромные тома , используя AsciiDoc ( статья в Википедии ) и любой любимый текстовый редактор. AsciiDoc похож на Markdown и семантически эквивалентен DocBook XML .

Прочитайте его сообщение в блоге, объясняющее, как он работает.

AsciiDoc может выводить в различные форматы, включая HTML , PDF , EPUB , man-страницы .

Можешь попробовать Макдаун . Он работает на macOS Sierra, где Mou не работает. Это идеальный редактор для разработчиков, таких как технические учебные пособия, поскольку он поддерживает подсветку синтаксиса (путем включения выделения блока кода синтаксиса на панели «Настройки визуализации » ). Вот полный список поддерживаемых синтаксисов блоков кода . Программное обеспечение с открытым исходным кодом, бесплатное для использования и выпущено под лицензией MIT.

MacDown, редактор Markdown для macOS

Связанный: редактор Markdown для OSX, который включает в себя предварительный просмотр, в идеале в режиме реального времени?

Спасибо за ответы. Оценив оба, я решил использовать Markdown для написания уроков, используя Mou в качестве текстового редактора. Он делает все, что мне нужно, является бесплатным, а затем позволяет мне copy to HTML.

Я использую веб-приложение StackEdit для управления сообщениями в блогах, руководствами Gist и ответами Stack Exchange. Это редактор уценки и имеет следующие важные функции:

  • Работает в автономном режиме

  • Синхронизация с Google Диском и Dropbox, т. е. редактирование на рабочем столе и планшете

  • Публикация в следующих сервисах

    блоггер, github, wordpress, другие

  • Экспорт форматов

    уценка, html, шаблон, pdf

  • Скопируйте HTML прямо из редактора