Maqaalka soo socda waxaan ku eegeynaa Formiko. Kani waa tifaftire yar oo lagu dhisay Python oo aan ku helay fursad GitHub. Formiko waa codsi reStructuredText oo leh tafatiraha MarkDown iyo horudhac si loo hubiyo horumarka shaqada la qabtay.
Qoraalka dib loo qaabeeyey waa qayb ka mid ah mashruuca 'Docutils' waxaana adeegsada barnaamijyada Python si ay u abuuraan dukumiinti farsamo. Waan hubaa inay jiri doonaan dad badan oo aan waligood maqlin dib-u-qaabeynta Qoraalka, laakiin barnaamijkan iyo fikradaha aasaasiga ah waxaad arki doontaa inay fududahay in la isticmaalo nidaamkan qaabeynta. Barnaamijku wuxuu ku qoran yahay Python oo ay la socdaan Gtk3, GtkSourceView, iyo Webkit2. Adeegso Goos gooska iyo dib u calaamadee Common Mark Parser.
Waa in la dhahaa Markdown iyo reStructuredText waxay leeyihiin awoodo lamid ah. Farqiga u dhexeeya, waa in la ogaadaa in reStructuredText loogu talagalay in lagu abuuro dukumiintiyo, wuxuu taageeraa miisaska iyo qoraallada hoose iyo qoraallada dambe
ReStructuredText waa nidaam fududeyn iyo akhrin oo la aqriyi karo. Waxay faa'iido u leedahay dukumiintiyada barnaamijka internetka, dukumiintiyada dukumiintiga Python, si dhakhso leh u abuurista bogag fudud oo fudud, iyo dukumiintiyada kaligood taagan. Dib-u-habeynta dib-u-habeynta ee loo yaqaan 'ReStructuredText parser' waa qayb ka mid ah 'Docutils' waana dib-u-eegis iyo dib-u-tarjumid nidaamyada calaamadaha miisaanka fudud ee StructuredText iyo Setext.
Astaamaha guud ee Formiko
Formiko
Sida ku xusan bogga mashruuca ee GitHub, Formiko waxaa ku jira astaamaha soo socda:
- Waxaan soo bandhigay tifaftire ku saleysan GtkSourceView oo leh Iftiiminta qoraalka iyo tifaftiraha Vim.
- Waan tagnaa qaybi goobta shaqada taagan ama jiifsan.
- Waxay bixisaa a Hordhac si loo arko sida shaqadu tahay.
- JSON iyo eegis ah HTML.
- Higaada higaada.
Waxay sidoo kale la jaan qaadi kartaa:
- Docutils dib -u -habayntaText -ka. Docutils HTML4, S5 / HTML Muqaal iyo WBS HTML qoraa.
- Calaamadeeyaha Calaamadaha Guud.
- Qoraa yar oo HTML ah.
- HTML 5 qoraa
Ku rakibida Foomka Ubuntu
Maqaalkan waxaan ku ku rakib Foomka Ubuntu 18.04. Waxaan ka heli doonnaa barnaamijkan mid loo heli karo Debian iyo BSD sida aan ku arki karno barnaamijkiisa Bogga GitHub.
Formiko vim
Shuruudaha
Kahor intaadan bilaabin rakibida, waa in la sheegaa in sida ku xusan boggooda GitHub, waa inaan ku qasban nahay qaar hagaaji shuruudaha kaas oo weydiinaya barnaamijka inuu si sax ah u shaqeeyo markaan ku rakibno pip3.
- Python 2.7 ama 3
- GTK+3
- gobject-isbarasho
- PyGObject
- Qalabka mareegaha
- GtkSourceView
Waxaan fureynaa terminal (Ctrl + Alt + T) oo waxaan u qornaa:
sudo apt install python3-pip python3-gi python3-docutils gir1.2-gtksource-3.0 \ gir1.2-webkit2-4.0 gir1.2-gtkspell3-3.0
Waxaan rabaa inaan caddeeyo markale inaan ku rakibayo qalabkan Ubuntu 18.04. Marka shuruudaha la buuxiyo, waan arki doonaa taas rakibidda barnaamijka waxaa lagu sameyn doonaa tuubbo ama apt maadaama aan danaynayno. Wixii isticmaal pip3 rakibidda waxaan ku qori doonnaa terminalka (Ctrl + Alt + T):
pip3 install formiko
Haddii aad doorbido isticmaal apt, isla terminaalka waxaan ku qoreynaa:
sudo apt update && sudo apt install formiko
Waa in la sheegaa in labada rakib ay na siin doonaan nooc isku mid ah barnaamijka. Ikhtiyaar ahaan waxaan sidoo kale rakibi karnaa:
sudo apt install vim-gtk3 pip3 install docutils-tinyhtmlwriter recommonmark docutils-html5-writer
Markii aan rakibno, laba galitaan ayaa lagu dari doonaa menu-ka arjiga: Formiko y Formiko vim.
Waxaan u baahan doonnaa mid ku habboon baahiyahayaga.
Furashada Formiko
Sidii aan aragnay laba ikhtiyaar rakibo, waxaan sidoo kale arki doonnaa laba amar si looga saaro barnaamijka nidaamkayaga hawlgalka.
Midka ugu horreeya ee amarradu wuxuu noqon doonaa kan tilmaamaya kan rakibidda lagu sameeyay pip3. Si loo baabi'iyo barnaamijka waxaan fureynaa terminal (Ctrl + Alt + T) oo aan ku qornaa:
sudo pip3 uninstall formiko
Hadda waxaan arki doonnaa amarka kuwa doortay rakibidda qalabka. Terminalka (Ctrl + Alt + T) waxaan ku qoreynaa:
sudo apt purge formiko && sudo apt autoremove
Ma noqon karto barnaamijyada ugu fiican shaqadooda, laakiin waa inaan dhahaa Formiko wuxuu ku shaqeeyey dhibaato la'aan intaan tijaabiyey. Ma doonayo inaan dhammeeyo aniga oo aan marka hore ka hadlin waxa laga yaabo inay tahay barta ugu weyn ee madow ee barnaamijkan, xaddidaadda qaabka kaas oo noo ogolaanaya inaan la shaqeyno
Macluumaad dheeraad ah oo ku saabsan barnaamijkan waxaa laga heli karaa bogga Mashruuca GitHub.