Ноу-хау: Markdown в любом приложении!

a/automator-markdown.png
28 июня 2018 (09:26:13)

Если на компьютере установлен pandoc — а это такая штука, которую настоятельно рекомендуется иметь установленной! — то под MacOS можно пользоваться возможностями Markdown в любом приложении, лишь бы оно умело работать с текстом.

Рецепт очень простой: открываем Automator и создаём в нём службу. Конфигурируем её так, как показано на картинке в «шапке», это одна минута ровно. Сохраняем. Всё.

Выделяем в приложении текст и дальше делаем одно из двух. Либо выполняем на выделенном тексте Ctrl+клик, либо идём в главное меню приложения. Там выбираем «Службы» и далее то, что было создано. Всё. Результатом будет HTML-код для выделенного текста в буфере обмена. Можно вставлять в админку блога или куда там нужно.

Если по какой-то причине не работает, то у вас скорее всего pandoc установлен в другом месте. Открываем терминал, говорим в нём which pandoc и подправляем соответственно путь в службе.

Если предполагается использование математики, то нужно добавить в вызывающий скрипт соответствующую опцию — так, для MathJax это ключ --mathjax; про другие движки см. документацию Pandoc.

Софт: заметки по MDwiki

25 июня 2018 (07:21:56)

Некоторые заметки про движок mdwiki, главным образом для внутреннего пользования. В дополнение к основному материалу.

При просмотре в мобильных браузерах может прилично тормозить, что и неудивительно: всё крутится на javascript и HTML5, то есть на клиентской стороне.

Налицо некоторые особенности типографики, вызванные парсингом Markdown средствами того же javascript:

  • неразрывный пробел, вставленный своим истинным символом (например, с клавиатуры Apple), ломается и превращается в обычный; его нужно вставлять HTML-аббревиатурой nbsp.
  • ударения, вставленные при помощи символа U+0301 после ударной гласной, ломаются; приходится пользоваться символами с диакритикой из европейских диапазонов кодировки.

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

Заголовок вики задаётся в конфиге config.json, но этого мало, и по-хорошему надо его указывать непосредственной правкой главного файла движка — там оно в самом начале, сразу видно.

Сноски не поддерживаются, но ремарки к тексту страниц можно оформлять цветными боксами. Например, абзац, начинающийся с «NB:», будет подсвечен. Можно добавить свои собственные слова для генерации боксов, в файле движка это ищется элементарно, однако требуется некоторая осторожность: если задать распространённое слово, начнёт подсвечиваться всё подряд. Чтобы избежать, можно комбинировать в ключевых словах кириллицу и латиницу — например, в слове «Описание» буквы «О», «са», «е» задать латиницей, а буквы «пи», «ни» кириллицей. Такое ключевое слово можно набрать, только специально постаравшись.

Книги: «Остров Сахалин» (Эдуард Веркин)

e/Eduard_Verkin__Ostrov_Sahalin.jpeg
13 июня 2018 (10:39:28)

Не люблю пост-ап как жанр, но Веркин такой Веркин… К тому же, анонсы обещали протагониста-футуролога, а вот футурологию я как жанр люблю. Если, конечно, написано настояще — вот как, скажем, у Ефремова или Лема.

Ну что — вставило. И упомянутое ожидание оправдалось, да и мир данного конкретного пост-апа очень даже ничего. Мир, в котором футурологам верят в разы больше, чем экономистам — просто потому, что первые кое-чего смогли предсказать по делу, а вторые предсказывали исключительно то, за что больше платили. Мир, в котором ценность жизни человека определяется товарной ценностью его трупа — а это хоть и ненулевая величина, но и не шибко много. Сколько там из одного трупа можно сварить мыла или путём сжигания получить тепла для электростанции?

Ну и авторский юмор, конечно. Который, конечно, есть, но который в данной книге есть наоборот. Если обычно у Веркина можно наблюдать юмор, переходящий в абсурд, то здесь наблюдается скорее абсурд, переходящий в юмор. И надо сказать, достаточно часто не просто переходящий, а перехлёстывающий. И так, знаете ли, конкретно перехлёстывающий. Настолько, что юмор, в свою очередь, переходит в жуть, плавно перетекающую в ту самую футурологию абсурда.

Вот такой «круг жизни», блин. Упёршийся в тупик. Хотите узнать, как оно такое получается — читайте.

MacOS и DokuWiki

25 мая 2018 (18:27:34)

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

Правда, для этого придётся немного потрудиться. Современные версии MacOS содержат «из коробки» веб-сервер Apache с модулем поддержки PHP, но он по умолчанию не активен. Нужно его активировать, немножко настроить, потом уже можно ставить движок и тоже его немножко настраивать.

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

Вторая часть универсальна. А вот про первую попрошу минуточку внимания:

Всё предлагаемое здесь ориентировано именно на персональную установку вики! Именно на MacOS, в предположении что доступ будет ограничен на уровне сервера и предоставлен для одного только хозяина вики! Как следствие, описываемые в конспекте настройки безопасности ни в коем случае нельзя применять при установке DokuWiki на внешний хостинг!

Сам конспект в виде PDF-файла забираем по ссылке.

Книги: «Не навреди» (Генри Марш)

n/ne-navredi.jpg
9 мая 2018 (05:39:56)

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

Автор этой книги — известный нейрохирург, умнейший дядька. И книжку свою написал умно — не только и не столько о своей работе и своих многочасовых операциях (хотя об этом тоже есть, и немало!) Книжка его написана в основном о трёх вещах: о сложности принятия решений, об ответственности перед людьми, и об общении с теми людьми, перед которыми несёшь моральную ответственность за принятые тобой решения. Очень, очень поучительно, а потому категорически рекомендуется к прочтению.

Хотя там и о другом написано очень интересно. Например, о работе автора в комиссии по аккредитации новых лекарств… о которых прямо говорится, что ради бабла фармацевтические компании зачастую предлагают полное фуфло только ради того, чтобы нажиться на надеждах больных (а кроме надежды, всё это фуфло ничего толкового и не предлагает).

Но всё-таки главная суть книги — вот в этой цитате:

Мало кто из людей, не имеющих отношения к медицине, понимает, что больше всего врачей терзает неопределённость, а не то, что они постоянно сталкиваются с человеческими муками и смертями.

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