Markowik

Markowik е Python приложение, което превръща Markdown форматиран текст на Google Code Wiki.
Markowik е в състояние да конвертира повечето евтино конструкции на своите Google Code Wiki (GCW) еквиваленти. Вместо да се описват всички поддържаните преобразувания, моля да погледнете в тестов пакет Markowik и неговата витрина.
<Силен> Монтаж
Стартирай:
PIP инсталирате markowik
или:
easy_install markowik
Можете да използвате и Markowik без инсталация, както е описано в Принос.
<Силен> Command Line Usage
От изхода помощ:
ползване: markowik [Н] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- HTML-изображения] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [OUTFILE]
Конвертиране Markdown да Google Code Wiki.
позиционни аргументи:
& Nbsp; INFILE евтино файл
& Nbsp; OUTFILE уики файл (по подразбиране: стандартния изход)
допълнителни аргументи:
& Nbsp; -Н, --help покаже това помощно съобщение и излизане
& Nbsp; - MX [MX [MX ...]] евтино разширения за да активирате
& Nbsp; - имидж-baseurl URL база URL да се добавя нищо към относителните местоположения снимка
& Nbsp; - HTML-изображения винаги използват HTML за снимки
& Nbsp; - кодиране ENCODING кодиране на входа и на изхода (по подразбиране: UTF8)
& Nbsp; - тихи забраните информационни съобщения
Евтино разширения могат да бъдат дадени по същия начин, както към Python Markdown (PyMD) командния ред инструмент, с изключение, че индивидуални разширения трябва да бъдат разделени от интервал:
markowik маси INPUT --mx def_list
В момента поддържа (т.е. тествани) удължения са съкр, маси, и def_list. Други разширения обикновено трябва да работят много, но може да доведат до неочаквани резултати в уики текста преобразувания.
По отношение на опционни --html-изображения, виж обясненията по-долу при ограничения.
<Силен> програмен Usage
Markowik се реализира в Python. Модулът markowik осигурява функция, наречена конвертирате. Семантично той е подобен на интерфейса на командния ред (аргументи ключови думи отговарят на командния ред). Ето кратък пример ползване:
>>> Внос markowik
>>> markowik.convert ("Някои * евтино * текстови ... ', MX = [' маси '])
u'Some _markdown_ текст ... "
<Силен> Page Pragmas
GCW страница pragmas могат да се задават в евтино изходни файлове като мета данни във формата, определена от мета разширяването PyMD:
>>> SRC = "" "Резюме: Резюме на страница
... Етикети: някои, етикети
...
... Тук започва страницата * * ..
... "" "
>>> Печат markowik.convert (SRC, MX = ['мета "])
#summary обобщена страница
#labels някои, етикети

Тук започва _page_ ..
Имайте предвид, че мета разширяването трябва да бъде включен изрично, т.е. по подразбиране Markowik не признава страница pragmas

Какво ново в тази версия:.

< ул>

Какво ново във версия 0.1.1:.

• Подобрена документация
• малки корекции.

<силни> Изисквания :

• Python

<силни> Ограничения :

• GCW да не изразя всичко маркиране възможно в Markdown. Това означава, евтино изходни файлове трябва да бъдат написани с по-долу ограничения в ума.

<Ли клас = "bbli"> URL адреси в Links и снимки:
• URL адреси, използвани за връзки или източници на изображението трябва да бъде абсолютна и трябва да имат специален протокол, за да се признава от GCW. По-специално, всяко URL трябва да започва с HTTP: //, HTTPS: //, или FTP: //. Markowik абортира преобразуването, ако установи, URL адреси не отговарящи на тези изисквания.

<Ли клас = "bbli"> Typefacing Линк Имена:
• GCW не поддържа typefacing в името на връзката. Например GCW прави името на линк в [http://foo.com _Foo_] буквално, тоест като _Foo_. Въпреки това, GCW признава typefacing в HTML връзки, т.е. & LT; един HREF = & quot; HTTP: //foo.com" & GT; _Foo_ & LT; / А & GT; Подчертано е правилно. Поради тази причина евтино връзки с вложените typefacing като [* Foo *] (http://foo.com) ще се преобразува в HTML връзки. В резултат на това, с връзки на етикети с някои специални знаци, които трябва да се избягва в GCW използване backtick (`) маркери също ще доведат до HTML връзки.

<Ли клас = "bbli"> Вложени Параграфи:
• GCW наистина не поддържа множество вложени точки (например в списъци или Блоковото цитиране). Markowik симулира многото вградени точки, като ги разделяте с & LT; BR / & GT; (Които визуално имитира точки, но не прекъсва гнездовия околната среда).

<Ли клас = "bbli"> Снимки:
• Markdown позволява да изразят алтернативни и заглавните текстове за снимки. Синтаксис изображение GCW не поддържа това. Единственият начин да се запазят тези текстове е да се използва обикновен HTML & LT; IMG & GT; тагове. Опцията --html изображения дава възможност тези промени.
• Друг въпрос е, че GCW очаква снимка URLs да завършват с разширение изображение тип файл. Markowik добавя изкуствени разширения снимка, ако е необходимо, например http://foo.bar/image е променен на http://foo.bar/image?x=x.png.

<Ли клас = "bbli"> Съкращения:
• GCW не маркиране за съкращения, нито пък подкрепи HTML тагове & LT; съкр & GT ;. Markowik преобразува съкращения на & LT; педя & GT; -elements какъв вид имитира съкращения (в ограничен мода разбира се)
.
<Ли клас = "bbli"> HTML:
• Всеки обикновен HTML срещащи се в източник на Markdown озовава буквално в GCW (с изключение на съдържанието на тагове педя ниво). Това е източникът на Markdown трябва да съдържа само HTML поддържа от GCW. Друг извод е, че URL адреси, използвани в обикновен HTML тагове не се проверяват за GCW съвместимост. С други думи: когато се използва сурово HTML сте на собствения си
!