Полтора месяца назад я жаловался что не нашел удобного средства делать pdf из markdown (и что pandoc таким не является).

Оказалось что всё еще хуже. Хотя формат cуществует всего десятилетие, там уже образовалась своя вавилонская башня. То есть существует как минимум два способа описания таблиц, причем pandoc поддерживает один из них, а fossil - другой. Поэтому из документации с таблицами, которая нормально показывается как embedded documentation в fossil-е нельзя ничего делать pandoc-ом без препроцессирования.

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

Успех пришел в виде сочетания питноновского модуля markdown (пакет python-markdown) и xhtml2pdf (пакет python-pisa). Это дело с неприличным названием я уже пробовал и получил кучу черных квадратиков вместо русских букв. Оказывается, оно всё что надо прекрасно умеет, надо только в CSS не забывать все что надо прописать.

Что-то вроде

media print {
   @font-face {
      font-family: Arial;
      font-weight: normal;
      src: url("/usr/share/fonts/truetype/msttcorefonts/Arial.ttf");
   }
}

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

Правда поддержку таблиц и сносок надо подключать как расширения к модулю markdown. И сноски, по-моему только в конце текста, потому что провзаимодействовать с css-ным описанием страниц по-моему у них не получится.

Upd: дальнейшее исследование показало что pandoc 1.12.4 понимает таблицы в том же формате, в каком их понимает fossil.

This entry was originally posted at http://vitus-wagner.dreamwidth.org/1035471.html. Please comment there using OpenID. Now there are comments

Some time ago I had a task to choose configuration management system for our Linux machines and came to the battle between Salt and Ansible. While technically these systems are similar, licensing models are different. Salt developers chose Apache license and Ansible stopped on GPL one. As a copyleft lover I shouldn't not even think much and Ansible would be my the only choice. However I decided to dig a bit and Google what other people think.

Ideas I keep in mind when I choose software licensed by copyleft license:
- this software is open
- this software will be open forever (or at least for a long period of time)
- developers and users are motivated to contribute

And generally this works for copyleft licensed software, but this is not a rule.

Coming back to Ansible vs Salt I found Salt community extremely active, friendly and welcoming. And this is the most reliable indicator that this piece of software is going to live long and open life. And thus I choose Salt, I choose community and not the license.

Some links to the topic:
http://ryandlane.com/blog/2014/08/04/moving-away-from-puppet-saltstack-or-ansible/
http://jensrantil.github.io/salt-vs-ansible.html

Тут slobin мне написал в комментарии что "скоро ты решишь что fossil вполне заменяет cheshirenet"
На самом деле, не решу.

По моей оценке на сейчас, fossil реализует примерно треть функциональности, которая необходима для чеширнета. Но реализует хорошо и это надо внимательно изучить.

Что такм есть:
1. Оффлайновый web в нескольких инкарнациях - wiki, репозиторий с контролем версии, багтракет
2. Достаточно эффективный протокол синхронизации. Что ценно, поверх http, поэтому через самые параноидальные корпоративные файрволлы ходит.
3. Компактный единственный исполняемый файл, который собирается под любую платфомру (правда под андроидом еще есть отдельная GUI0ншаня приблуда) и работает хоть как сам себе сервер (в том числе и в виде виндового сервиса) хоть через почти любой интерфейс к сущесвующему серверу, хоть в командной строке доставая исходники wiki-страниц для редактирвоания и складывая их обратно

Какие недостатки я заметил в fossil (в рамках того, что там сделано)

1. Отсутствие чайникового инсталлятора для Win32. С этим можно примириться в случае инструмента для разработчиков. Разработчик все равно знает, как запускать команды из командной строки, что в Windows понимается под словом "service" и где там конфигурится firewall. Поэтому вполне в состоянии выполнить команду

fossil winsrv create.

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

2. Отсутствие wiki-расширений в markdown-разметке. Получается, что либо у тебя есть удобные wikilinks, либо у тебя есть удобная разметка, либо вообще пиши все в HTML. Я подозреваю, что Хипп не зря отрицательно относится к Wiki, и настоятетльно на всех углах рекомендует вместо wiki использовать embedded documentation (т.е. возможность в веб-интерфейсе fossil показывать файлы из репозитория, красиво их форматируя). Практика показывает что в мире Open Source "документировано в wiki" означает "не документировано совсем".
Расширить фоссиловский markdown для удобного пользования именно в качестве wiki (и в тикетах) по моему было бы полезно. Кроме быстрых wikilinks крайне не хватает автоматической генерации оглавлений. Причем последняя как раз была бы полезнее в embedded documentation.

3. fossil не очень поддерживает сетевые структуры репозиториев произвольной глубины.Оно все-таки расчитано на звездообразную схему - центральный репозиторий, локальные репозитории разработчиков и рабочие чекауты.
Наоборот, Хипп принял специальные меры чтобы ограничить копирование информации о юзерах при клонировании и синхронизации репозиториев. У него модель доверия/недоверия весьма рациональная для области применения fossil, но не для области применения cheshirenet. Для того чтобы пропихнуть в вышестоящий репозиторий информацию о пользователях своего - нужно иметь в вышестоящем админские права.

4. Некоторые странички равнее других. Почему-то в wiki страничках комментировани (append в местной терминологии) возможно, а в event-ах нет. Ну и переключиться в форматировании на markdown можно не везде. Хотя вообще-то markdown это полумера - для чеширнета нужен wysiwyg. (а как работает wysiwyg html-редактирование в fossil я еще не изучал).

Из того что должно быть в чеширнете, но нет и не нужно в fossil-е -

1. peer discovery во всяких локальных сетях.
2. подписка (в смысле просьба к peer-у поискать некоторый контент у своих peer-ов)
3. Концепция псевдонимов с криптографической защитой целостности блоков информации (того, что в fossil называется артефактом). Кстати, какая-никакая защита в fossil-е есть. Там артефакт идентифицируется хэшом. Поэтому измененный артефакт будет другим артефактом. Но идея подписей в чеширнете связывает артефакт с псевдонимом его автора/публикатора.
4. Самое главное - fossil это система для хранения истории. Он не умеет автоматичесаи удалять устаревший контент. Для системы с большим траффиком, каковой планируется cheshirenet- это непримемлемо

This entry was originally posted at http://vitus-wagner.dreamwidth.org/1033786.html. Please comment there using OpenID. Now there are comments

Вот вспомнил, выйдя с работы, что что-то забыл, можно прямо на телефоне тикет написать. Независимо от наличия сотовой сети и интернета в ней.

Нет, Ричард Хипп это самый великий программист первой четверти XXI века.

Надо прям в спейсианском вики написать, что город, в котором расположен университет Лемурии в честь него (а не какого-то однофамильца) назван.

Вот только объяснил бы кто, как в андроидном fossil между репозиториями переключаться ( впрочем, андроидный GUI вроде не он писал).

This entry was originally posted at http://vitus-wagner.dreamwidth.org/1033284.html. Please comment there using OpenID. Now there are comments

14 декабря в Омске пройдет GDG DevFest 2014 — уникальная возможность для молодых и опытных IT-специалистов погрузиться в мир новых и перспективных информационных технологий! На мероприятии вы сможете создать собственное приложение с использованием технологических новинок этого года, в том числе, Android Wear SDK, Web Components, Polymer и Cardboard VR SDK, а также узнать всю необходимую для этого теорию!

Читать дальше →