Limbajul de marcare Markdown. Unele servicii web care acceptă Markdown. Cei mai buni editori profesioniști de Markdown

Scrierea de articole pe web a fost întotdeauna împovărată de necesitatea de a formata conținutul în HTML. Scrierea și publicarea conținutului nu este ușoară, deoarece trebuie să cunoașteți cel puțin etichetele HTML de bază.

În acest caz, pierdeți capacitatea de a publica rapid o postare pe un blog sau pe o pagină web. Titluri, caractere aldine, cursive, liste cu marcatoriși numerotarea - trebuie să poți face toate aceste trucuri. Acest proces poate fi destul de obositor pentru bloggerii obișnuiți, așa că nașterea Markdown este ca o gură de aer proaspăt pentru creatorii de conținut.

Dar Markdown poate fi util nu numai pentru cei care lucrează pe internet. De asemenea, poate acționa ca o sintaxă simplă care facilitează formatarea și scrierea în text simplu pentru toată lumea, indiferent dacă scrieți o notă pentru dvs. sau un fișier Markdown pentru alții. publicare ulterioară pe internet.

Markdown este un limbaj de marcare ușor. Creat inițial de John Gruber și Aaron Swartz, al căror scop a fost să creeze un limbaj de markup ușor, cât mai ușor de citit și de publicat. Multe dintre ideile limbii au fost împrumutate din convențiile existente pentru marcarea textului în e-mailuri.

Scopul Markdown este de a facilita scrierea, editarea și citirea conținutului web utilizatorii obișnuiți. Simplitatea constă în faptul că tot ce trebuie să faceți este să vă familiarizați cu și să vă amintiți sintaxa acestui limbaj simplificat.

Comenzi Markdown

Legături

Titluri

#H1
## H2
### H3

Liste

Lista simplă:

- punctul 1
- punctul 2
- punctul 3

Lista numerotata

1. punctul 1
2. punctul 2
3. punctul 3

Pentru a utiliza limbajul ușor Markdown de care aveți nevoie aplicatii speciale- text Editori Markdown. Le puteți descărca de pe App Store sau de pe alte site-uri dacă există o licență gratuită.

Cele mai bune vizualizatoare Markdown

Marcat 2

Preţ: versiune de încercare - gratuită, versiunea completă- 13,99 USD.

Una dintre cele mai multe programe populare pentru a vizualiza texte în format Markdown. Documentele sunt actualizate în timp real pe măsură ce le editați. Toată atenția este concentrată asupra textului în sine. Programul funcționează atât cu documente Markdown, cât și cu text obișnuit.

Cei mai buni editori Markdown

MarkMyWords

Preţ: 1.150 de ruble.

Cele mai multe functie importanta această aplicație poate lucra cu fișiere CSS, precum și suport opțiuni convenabile lucrul cu documente.

Texte

Preţ: gratuit.

Texts este un editor de text conceput pentru a separa prezentarea conținutului de procesul de creare a acestuia. Funcționează ca în mod normal procesor de text, dar în același timp păstrează documente gata sub formă de text simplu cu marcaj Markdown, făcându-l compatibil cu alte aplicații compatibile Markdown. Acesta creează documente care sunt complet gata pentru publicare pe Internet.

Markdown Pro

Preţ: 379 de ruble.

Markdown Pro vă oferă toate instrumentele de care aveți nevoie pentru a crea documente frumoase, bine formatate, folosind limbajul de marcare Markdown. De asemenea, se străduiește să facă procesul de scriere distractiv și interesant. Programul acceptă exportul către formate PDF sau HTML. Markdown Pro este un editor Markdown flexibil, de înaltă calitate, pentru documente, note, articole și multe altele.

Markdown ușor

Preţ: 749 de ruble.

Easy Markdown facilitează, de asemenea, editarea și formatarea documentelor Markdown pentru toată lumea. Traduce automat textul în format web bogat folosind formatarea de bază Markdown. Puteți introduce text în panoul din stânga și puteți vizualiza rezultatul final din dreapta și, de asemenea, salvați codul în format HTML sau RTF în orice moment în timp ce lucrați la document.

nvALT

Preţ: gratuit.

nvALT 2 este un fel de ram al popularului editor de text Notational Velocity, dar cu capabilități extinse și o interfață modificată. Unele dintre acestea includ capacitatea de a scrie și edita fișiere text în Markdown.

Nottingham

Preţ: gratuit.

Inspirat de eleganța și flexibilitatea editorului Notational Velocity, Nottingham este un editor Markdown simplu și ușor pentru Mac, care acceptă vizualizarea live a textului Markdown și a formatelor de înregistrare. Designul general este foarte asemănător cu Notational Velocity, astfel încât utilizatorii se vor simți ca acasă lucrând cu acest program.

iA Scriitor

Preţ: 749 de ruble.

Unul dintre cei mai buni editori Markdown. iA Writer acceptă număr mare Sintaxa Markdown. ÎN ultima versiune iA Writer poate fi utilizat Combinație Ctrl+ Cmd + R pentru a activa previzualizarea. Clientul este disponibil și pe iPhone și iPad.

Proverb

Preţ: 899 de ruble.

Byword este un alt editor Markdown foarte faimos pentru Mac și pentru cei care doresc o interfață elegantă și simplă. Pe lângă frumos interfata utilizator aplicația se laudă cu un aspect minimalist care nu distrage deloc atenția de la muncă. Există și o versiune pentru iPhone și iPad.

Notă

Preţ: gratuit.

Punctul culminant al acestei aplicații este suportul pentru evidențierea sintaxei. Previzualizare Documentul poate fi lansat folosind comanda rapidă de la tastatură ⌥ + ⌘ + P.

Cei mai buni editori profesioniști de Markdown

MultiMarkdown Composer

Preţ: 379 de ruble.

MultiMarkdown Composer este un editor de text puternic care acceptă atât formatele Markdown, cât și MultiMarkdown, precum și sintaxa avansată Markdown: tabele, note de subsol, citate.

Mou

Preţ: gratuit.

În timp ce majoritatea editorilor Markdown sunt concepute pentru bloggeri și utilizatori obișnuiți, Mou este conceput pentru mai mult utilizatori experimentați, cum ar fi dezvoltatorii web.

Caiete

Preţ: gratuit.

Caiete este aplicație desktop. Vă permite să stocați și să sincronizați notele cu versiunea iOS, permițându-vă să descărcați notele în orice moment. Notebooks acceptă formatul Markdown și vă permite să îl editați, să îl vizualizați și să îl convertiți în HTML.

Scrierea de articole pe web a fost întotdeauna împovărată de necesitatea de a formata conținutul în HTML. Scrierea și publicarea conținutului nu este ușoară, deoarece trebuie să cunoașteți cel puțin etichetele HTML de bază.

În acest caz, pierdeți capacitatea de a publica rapid o postare pe un blog sau pe o pagină web. Titluri, font aldine, cursive, liste cu marcatori și numerotare - toate aceste trucuri pe care trebuie să le puteți face. Acest proces poate fi destul de obositor pentru bloggerii obișnuiți, așa că nașterea Markdown este ca o gură de aer proaspăt pentru creatorii de conținut.

Dar Markdown poate fi util nu numai pentru cei care lucrează pe internet. De asemenea, poate acționa ca o sintaxă simplă care facilitează formatarea și scrierea în text simplu pentru toată lumea, indiferent dacă scrieți o notă pentru dvs. sau un fișier Markdown pentru a posta online.

Markdown este un limbaj de marcare ușor. Creat inițial de John Gruber și Aaron Swartz, al căror scop a fost să creeze un limbaj de markup ușor, cât mai ușor de citit și de publicat. Multe dintre ideile limbii au fost împrumutate din convențiile existente pentru marcarea textului în e-mailuri.

Scopul Markdown este de a face scrierea, editarea și citirea conținutului web mai ușoară pentru utilizatorii obișnuiți. Simplitatea constă în faptul că tot ce trebuie să faceți este să vă familiarizați cu și să vă amintiți sintaxa acestui limbaj simplificat.

Comenzi Markdown

Legături

Titluri

#H1
## H2
### H3

Liste

Lista simplă:

- punctul 1
- punctul 2
- punctul 3

Lista numerotata

1. punctul 1
2. punctul 2
3. punctul 3

Pentru a utiliza limbajul ușor Markdown, aveți nevoie de aplicații speciale - editori de text Markdown. Le puteți descărca din App Store sau de pe alte site-uri dacă există o licență gratuită.

Cele mai bune vizualizatoare Markdown

Marcat 2

Preţ: versiunea de încercare este gratuită, versiunea completă este de 13,99 USD.

Unul dintre cele mai populare programe pentru vizualizarea textelor în format Markdown. Documentele sunt actualizate în timp real pe măsură ce le editați. Toată atenția este concentrată asupra textului în sine. Programul funcționează atât cu documente Markdown, cât și cu text obișnuit.

Cei mai buni editori Markdown

MarkMyWords

Preţ: 1.150 de ruble.

Cea mai importantă caracteristică a acestei aplicații este capacitatea de a lucra cu fișiere CSS, precum și suportul pentru opțiuni convenabile pentru lucrul cu documente.

Texte

Preţ: gratuit.

Texts este un editor de text conceput pentru a separa prezentarea conținutului de procesul de creare a acestuia. Funcționează ca un procesor de text obișnuit, dar salvează documentele finite ca text simplu cu marcaj Markdown, făcându-l compatibil cu alte aplicații compatibile Markdown. Acesta creează documente care sunt complet gata pentru publicare pe Internet.

Markdown Pro

Preţ: 379 de ruble.

Markdown Pro vă oferă toate instrumentele de care aveți nevoie pentru a crea documente frumoase și bine formatate folosind limbajul de marcare Markdown. De asemenea, se străduiește să facă procesul de scriere distractiv și interesant. Programul acceptă exportul în format PDF sau HTML. Markdown Pro este un editor Markdown flexibil, de înaltă calitate, pentru documente, note, articole și multe altele.

Markdown ușor

Preţ: 749 de ruble.

Easy Markdown facilitează, de asemenea, editarea și formatarea documentelor Markdown pentru toată lumea. Traduce automat textul în format web bogat folosind formatarea de bază Markdown. Puteți introduce text în panoul din stânga și puteți vizualiza rezultatul final în partea dreaptă și puteți salva oricând codul în format HTML sau RTF în timp ce lucrați la documentul dvs.

nvALT

Preţ: gratuit.

nvALT 2 este un fel de ram al popularului editor de text Notational Velocity, dar cu capabilități extinse și o interfață modificată. Unele dintre acestea includ capacitatea de a scrie și edita fișiere text în Markdown.

Nottingham

Preţ: gratuit.

Inspirat de eleganța și flexibilitatea editorului Notational Velocity, Nottingham este un editor Markdown simplu și ușor pentru Mac, care acceptă vizualizarea live a textului Markdown și a formatelor de înregistrare. Designul general este foarte asemănător cu Notational Velocity, astfel încât utilizatorii se vor simți ca acasă lucrând cu acest program.

iA Scriitor

Preţ: 749 de ruble.

Unul dintre cei mai buni editori Markdown. iA Writer acceptă o cantitate mare de sintaxă Markdown. În cea mai recentă versiune a iA Writer, puteți folosi combinația Ctrl + Cmd + R pentru a activa previzualizarea. Clientul este disponibil și pe iPhone și iPad.

Proverb

Preţ: 899 de ruble.

Byword este un alt editor Markdown foarte faimos pentru Mac și pentru cei care doresc o interfață elegantă și simplă. Pe lângă o interfață de utilizator frumoasă, aplicația se mândrește cu un aspect minimalist care nu distrage deloc atenția de la muncă. Există și o versiune pentru iPhone și iPad.

Notă

Preţ: gratuit.

Punctul culminant al acestei aplicații este suportul pentru evidențierea sintaxei. Puteți începe să previzualizați un document utilizând comanda rapidă de la tastatură ⌥ + ⌘ + P.

Cei mai buni editori profesioniști de Markdown

MultiMarkdown Composer

Preţ: 379 de ruble.

MultiMarkdown Composer este un editor de text puternic care acceptă atât formatele Markdown, cât și MultiMarkdown, precum și sintaxa avansată Markdown: tabele, note de subsol, citate.

Mou

Preţ: gratuit.

În timp ce majoritatea editorilor Markdown sunt concepute pentru bloggeri și utilizatori ocazionali, Mou este conceput pentru utilizatorii mai avansați, cum ar fi dezvoltatorii web.

Caiete

Preţ: gratuit.

Notebooks este o aplicație desktop. Vă permite să stocați și să sincronizați notele cu versiunea iOS, permițându-vă să descărcați notele în orice moment. Notebooks acceptă formatul Markdown și vă permite să îl editați, să îl vizualizați și să îl convertiți în HTML.

- foarte simplu si elegant sintaxa de marcare a textului, care acum câștigă rapid avânt în popularitatea sa în Statele Unite, câștigând înregistrarea în formulare de comentarii, editori online și alte locuri pentru introducerea de texte mari care necesită o formatare vizuală complexă și atentă.

Și deși am crezut întotdeauna că inventarea de noi este și mai simplificată sintaxele pentru HTML deja simplu este rău, mi-a plăcut Markdown, probabil cel mai chibzuit dintre cei pe care i-am văzut și cei mai... discreti. În acest articol de recenzie vom sublinia și diferența conceptuală dintre Markdown și marcare wiki, cel mai apropiat ideologic de el.

Formatare și Web 2.0

Era actuală a Web 2.0 diferă de cea anterioară prin aceea că acum utilizatorii site-urilor web pot crea în mod masiv conținut pe aceste site-uri. Aceasta include sisteme dezvoltate pentru comentarea materialelor, blogurilor și rețelelor sociale, în care conținutul este creat în întregime de utilizatorii înșiși.

Pentru ca utilizatorii să creeze mesaje convenabile, se folosesc diverse progrese în programarea web, până la text special, cum ar fi în WordPress. Acestea sunt editori de text cu drepturi depline set de bază funcții de editare.

Cu toate acestea, astfel de editori WYSIWYG nu satisfac întotdeauna utilizatorii avansați. Mai mult, unele implementări ale editorilor în browsere diferite poate părea groaznic sau nu funcționează deloc. Prin urmare, multe site-uri vă permit să creați mesaje chiar și folosind HTML pur.

Dar de asemenea HTML pur nu este întotdeauna bun datorită nu atât din cauza complexității sale, cât din cauza greoiului codului, în care este ușor să te confuzi. Prin urmare, s-au inventat multe limbaje simplificate markupuri, cum ar fi markup wiki, care ajută utilizatorii să-și formateze mai ușor postările folosind un simplu sintaxa textului.

În acest articol, vom lua în considerare un exemplu de sintaxă text numită, care este în multe privințe superioară metodelor deja menționate în comoditatea și ușurința formatării textului web.

Aşa, Markdown- un format de text simplu ușor de scris și citit, care este apoi ușor convertit într-un format structural HTML valid. În aparenţă Markdown foarte asemănător cu marcare wiki. Mai jos evidențiem caracteristicile Markdown ca sintaxă independentă.

Markdown (reducere) este un limbaj ușor de marcare a textului pentru publicarea web. Creat inițial John Gruber(ing. John Gruber) și Aaron Schwartz, al cărui scop a fost să creeze un limbaj de markup ușor, cât mai ușor de citit și de publicat. Implementările limbajului Markdown convertesc textul formatat Markdown în XHTML valid și bine format și înlocuiesc parantezele unghiulare din stânga ("<»), ampersand(“&”) și așa mai departe la codurile de entitate corespunzătoare.

Principii Markdown

Sintaxa Markdown a fost inventată inițial de dezvoltatori John GruberŞi Aaron Schwartzîn scopul publicării cu ușurință a exemplelor de cod HTML pe site-uri web. La urma urmei, atunci când în mod normal publici exemple HTML pe o pagină web, trebuie să te chinui foarte mult cu înlocuirea parantezelor unghiulare cu secvențe de caractere< и >și așa mai departe.

Apropo, aș dori să vă atrag atenția asupra faptului că, în multe implementări de încorporare a Markdown în site-urile web pe care le-am văzut, aproape de fiecare dată când își scriu propriul filtru de intrare/ieșire, din anumite motive ignorând (sau pur și simplu neștiind) că în Reducere PHP are propriul parser de filtru încorporat. Care este scopul minunatei opțiuni de dezinfectare de intrare, care poate fi găsită în partea de sus a clasei Markdown_Parser (fișierul arkdown.php), și iată variabilele responsabile pentru activarea acesteia și valorile lor implicite:

Var $no_markup = false; var $no_entities = false;

Dacă le setați la true , de exemplu, astfel:

Funcția do_markdown($text, $safe=false) ( $parser = nou Markdown_Parser; if ($safe) ( $parser->no_markup = true; $parser->no_entities = true; ) return $parser->transform($text ;

Acum funcția își va crea propriul analizator, care va curăța întregul flux de caractere.

În ceea ce privește suportul gata făcut pentru Markdown, această sintaxă este deja destul de comună pe multe site-uri. De exemplu, poate fi folosit în retea sociala Diaspora. Markdown este acceptat direct sau prin pluginuri în sistemele CMS Drupal, Plone, TYPO3, Django, DokuWiki.

Multe editoare de text simplu, precum și mediile de dezvoltare a aplicațiilor, acceptă și Markdown cel puțin la nivelul de evidențiere a codului. Aceasta include editorii Vim, Emacs, Gedit, BBedit, TextMate, IDE Eclipse. De exemplu, să luăm un plugin pentru editor Gedit. Vă permite să previzualizați textul formatat printr-un vizualizator HTML într-o fereastră separată:


Abonați-vă la actualizările blogului →,

Poate principala descoperire din spate în ultima vreme pentru mine nu a devenit ceva tehnologie nouă sau nou serviciu convenabil, un... limbaj de marcare. S-ar părea că ce ar putea fi remarcabil aici? Numai dacă despre care vorbim nu despre Markdown. Idee simplă, modul în care puteți formata textul și îl puteți transforma în HTML valid, a devenit atât de reușit încât poate fi folosit aproape peste tot. Și datorită popularității Markdown în cercurile hackerilor, un complet nou noua abordare(și servicii) pentru a publica conținut bazat pe fișiere statice.

Reducere? Ce este asta?

Cel mai simplu mod de a explica semnificația Markdown este cu un exemplu simplu. Pentru a crea o listă de lucruri de făcut, folosesc cea obișnuită fișier text, in care scriu:

Lista de lucruri de făcut: - scrieți un articol despre Markdown - faceți ilustrații - trimiteți editorului

Fiecare dintre noi știe cum să formateze structuri complexe în text simplu simplu, iar acesta este semnificația principală a Markdown. De exemplu, textul dat poate fi convertit imediat în HTML, iar interpretul Markdown (să zicem, implementat ca plugin pentru un editor de text precum SublimeText sau Notepad++) recunoaște însuși că are de-a face cu o listă neordonată:

Lista de lucruri de făcut:

  • scrie un articol despre Markdown
  • realizați ilustrații
  • trimite text la editor

După cum scrie însuși autorul Markdown, John Gruber, ideea limbajului este că sintaxa ar trebui să fie atât de simplă, compactă și evidentă încât documentul marcat să rămână pe deplin lizibil și o persoană neinițiată ar putea chiar decide că acesta este text simplu. Cum atinge Markdown acest rezultat?

Hai să mai luăm puțin exemplu complex. Imaginați-vă că trebuie să creați o listă numerotată. Evident, vei pune numărul corespunzător în fața fiecărui articol. Trebuie să te concentrezi asupra unor cuvinte? Probabil ai făcut asta folosind câteva simboluri.

# Titlu ## Subtitlu În acest paragraf trebuie să: 1. evidențiați ceva cu **bold** și *italic* 2. puneți un link către site-ul web al autorului - (http://daringfireball.net) 5. citați codul , de exemplu, ` imprimați „Bună, lume!”` 3. și introduceți un portret al autorului![John Gruber](http://daringfireball.net/graphics/author/addison-bw-425.jpg)

Acest exemplu arată clar cât de lizibil rămâne textul. De fapt, nu au venit cu o soluție evidentă doar pentru inserarea de link-uri și imagini, plus că inițial limbajul nu vă permitea să determinați scara imaginii. Ca rezultat al procesării de către interpret la ieșire, obținem codul final:

Titlu

Subtitlu

În acest paragraf aveți nevoie de:

  1. evidentia ceva îndrăzneţŞi cursive
  2. pune un link către site-ul autorului - Daring Fireball
  3. citați codul, de exemplu, printează „Bună, lume!”
  4. și introduceți un portret al autorului

De fapt, cunoașteți deja sintaxa Markdown - toate celelalte nuanțe pot fi stăpânite în cinci minute citind manualul oficial (daringfireball.net/projects/markdown/syntax).

Cui îi pasă de un acordeon cu nasturi de capră?

Bine, limbajul de marcare este foarte simplu și ușor de înțeles. Dar unde poate fi folosit? De ce este necesar acest lucru? Acronimul obosit WYSIWYG și-a dovedit de multă vreme inconsecvența în rândul utilizatorilor avansați. Am încercat să folosim o abordare vizuală atunci când proiectăm materiale pe , și a fost o groază liniștită. Editorii WYSIWYG, chiar și cei foarte buni, funcționează strâmb și, în cazul aspectului complex, încep să se defecteze. Multe lucruri complexe erau imposibil de făcut în principiu. Nu utilizați HTML formă pură(deși să fim sinceri, uneori facem asta)? Aceeași Wikipedia, încă de la începutul existenței sale, a oferit markup wiki special conceput. Și orice motor de forum mai mult sau mai puțin inteligent acceptă bbcode sau ceva similar. Există o singură problemă: marcajul este folosit, dar este diferit peste tot. Markdown a fost imediat plăcut de mulți, drept urmare multe resurse populare l-au adoptat. Fără îndoială, este mult mai convenabil să scrii un comentariu pe forum folosind marcajul Markdown decât HTML pur, ale cărui etichete sunt ușor de confundat. Acesta este motivul pentru care serviciile tumblr și posterous acceptă acest mod de blogging. Multe CMS-uri acceptă, de asemenea, marcajul Markdown: Drupal, Plone, RadiantCMS - și cadrele: Django (este necesară instalarea python-markdown), Ruby on Rails (este necesară instalarea BlueCloth, Maruku).

Suportul pentru sintaxă este disponibil în orice care se respectă editor de text, iar opțiunea de previzualizare rapidă este ușor de conectat sub formă de pluginuri. În plus, sunt multe redactori de specialitate, conceput inițial pentru a funcționa cu Markdown (puteți alege pe cel potrivit citind o bară laterală separată). Iar interpreții pentru procesarea limbajului de marcare sunt implementați în orice limbă, așa că, indiferent dacă proiectul dvs. este în Python, PHP, Ruby sau orice altceva, puteți oferi Markdown utilizatorilor de pretutindeni. Mai departe - mai mult. Markdown a devenit atât de popular încât formează baza multor servicii. De exemplu, pornirea scriptogr.am, care câștigă amploare, vă permite să transformați fișierele statice formatate în Markdown și postate în Dropbox în frumos blog(cu posibilitatea de a se conecta la orice domeniu). Ideea preluată a evoluat rapid în cercurile geek și a crescut în crearea de motoare precum Octopress.

Octopress este o soluție foarte funcțională pentru blogul tău confortabil

Editori pentru lucrul cu Markdown

Nu există nicio îndoială că Markdown poate face viața mult mai ușoară. Dar pentru a-l folosi și mai productiv, trebuie să lucrați cu software care îl acceptă. Mă grăbesc să vă mulțumesc: editorii obișnuiți precum SublimeText, TextMate, Vim și Emacs, pe care probabil le folosiți, se înțeleg bine cu Markdown dacă îi învățați asta folosind pluginuri. Pentru Sublime acestea sunt Sublimetext-markdown-preview și SublimeMarkdownBuild, pentru TextMate - Markdown.tmbundle, pentru Vim - Vim-markdown și Vim-markdown-preview și pentru Emacs - Emacs Markdown Mode. Sau puteți folosi editori specializați.

Windows

ÎN vedere generală lucrul cu blogul va arăta astfel: set to mașină locală Server Octopress, scrieți postări în fișierele Markdown, editați șablonul (dacă este necesar), executați o comandă în consolă pentru a genera conținut și, în final, încărcați HTML + JS rezultat în depozitul nostru de pe GitHub. Ei bine, acum, în ordine.

  1. Primul punct instalare în curs Octopress 2.0. Pentru ca acesta să funcționeze, aveți nevoie de instalat Ruby 1.9.2. În plus, trebuie instalat și Git. Mai întâi, descărcați sursele Octopress, pregătiți-le și instalați-le: git clone git://github.com/imathis/octopress.git cd gem install bundle bundle install
  2. Apoi instalați tema standard Octopress.
  3. instalarea greblei
  4. În continuare, trebuie să configuram Octopress să funcționeze cu depozitul nostru: rake setup_github_pages

    În timpul sarcinii, ni se va cere să introducem adresa URL a depozitului nostru. În principiu, după aceasta puteți deja publica. Acest lucru se face cu o singură comandă: rake gen_deploy

    sau doua:

    Rake generate rake deploy

  5. Înainte de implementare, puteți efectua și o previzualizare rake, care va lansa un server web local la http://0.0.0.0:4000, unde puteți vedea ce a generat Octopress. Dacă trebuie să corectați ceva în configurație, trebuie să vă referiți la fișierul _config.yml.

    Acum este timpul să creați prima postare: rake new_post["Post Title"] Un dosar cu data curentă

    și titlul postării, în format Markdown. Luați orice editor Markdown care vă place, editați fișierul și publicați postarea:

Gata, poți să mergi la adresa blogului și să verifici cum a fost publicată prima intrare. Dacă trebuie să vă conectați blogul la un domeniu personalizat, atunci acest lucru este ușor de realizat folosind instrucțiuni simple (bit.ly/MWgR3f). La prima vedere, această abordare poate părea ciudată, dar de fapt este extrem de convenabilă. Site-ul funcționează foarte repede deoarece este format din fișiere statice și este găzduit pe site-uri de încredere. Datorită GitHub, oricine poate propune modificări la postări – iar tu le poți aplica cu ușurință. Octopress în sine oferă un șablon HTML5 excelent, cu o mulțime de bunătăți precum conexiune rapidă sistem extern comentarii (de exemplu, Disqus). Desigur, această poveste nu este despre oameni obișnuiți, dar nu vorbim despre ele.

Alte generatoare statice de site

Trebuie spus că Octopress nu este singurul instrument de generare continut static. Aș dori să vă atrag atenția asupra încă două instrumente: Poole (bitbucket.org/obensonne/poole) și BlazeBlogger (blaze.blackened.cz).

Poole este un generator de site static care utilizează Markdown. Este scris în Python și nu necesită altceva decât să funcționeze. Este foarte ușor de lucrat cu: creați conținutul paginilor web folosind Markdown - iar Poole le transformă într-un site simplu și frumos, echipat cu meniul de navigare. Principiul de funcționare este simplu: programul preia fișiere din directorul de intrare și le copiază în directorul de ieșire, în timp ce toate fișierele cu extensia md, mkd, mdown sau markdown sunt convertite în HTML cu page.html ca cadru. Dacă doriți să înlocuiți aspect site-ul, va trebui să editați fișierele page.html și input/poole.css. Pentru a actualiza, modifica, adăuga conținut, trebuie să faceți:

> poole.py --build

După care Poole vă va regenera site-ul.

Un alt instrument pentru crearea unui site web static este BlazeBlogger. Nu necesită baze de date sau scripturi pe server pentru a funcționa. Tot ce aveți nevoie este un interpret Perl instalat. Markdown este, de asemenea, folosit pentru a crea conținut, astfel încât să vă puteți crea blogul în orice editor Markdown doriți. Principalele caracteristici includ: crearea de pagini HTML 4.01 sau XHTML 1.1 valide și fluxuri RSS 2.0; generarea de arhive lunare și anuale, suport pentru etichete; vă permite să creați atât postări de blog, cât și doar pagini; vă permite să schimbați rapid tema, stilurile CSS sau localizarea. Informații detaliate Puteți privi opțiunile tuturor utilităților care vin cu BlazeBlogger pe site-ul oficial.

Markdown: ce urmează?

O idee simplă evoluează constant. Prima implementare, scrisă de John Gruber, a fost un script Perl obișnuit. Ca limbă nouă marcajul a câștigat popularitate, au apărut noi implementări, scrise dezvoltatori terțiîn C#, C, Common Lisp, Haskell, Java, JavaScript, Lua, newLISP, Perl, PHP, Python, Ruby, Scala de către dezvoltatori terți care s-au ghidat după prima implementare, care a devenit un fel de standard. Pe lângă implementările pe limbi diferite programare, există și aplicații care extind sintaxa Markdown cu funcționalități suplimentare, precum MultiMarkdown și pandoc. Dialectele Markdown vă permit să lucrați cu documente din mai multe fișiere, să creați automat tabele, să colectați bibliografii, să inserați matematică în MathML și să combinați codul cu alte limbaje de aspect, inclusiv LaTeX, HTML și altele. Dialectele avansate pot automatiza diverse lucruri: de exemplu, introducerea tipografiei corecte. În plus, puteți scoate nu numai în HTML, ci și în PDF, RTF, ODT și chiar pagini de manual (oamenii care au văzut cel puțin o dată sintaxa limbajului troff o vor aprecia). Toate acestea vă permit să utilizați Markdown cel mai mult în scopuri diferite: scrieți documentație, cărți și site-uri web întregi.

Această sintaxă elegantă de marcare câștigă popularitate în întreaga lume. Sincer, Markdown este ca un drog - odată ce încercați să scrieți o postare în el, este puțin probabil să vă întoarceți la HTML obișnuit. Voi simti avantajul. Folosind Markdown pentru a scrie acest articol, nu numai că îl pot converti în PDF, ci și îl pot publica pe site fără niciun efort suplimentar. Iar editorii, care au devenit atrași de Markdown, se gândesc deja serios la dezvoltarea de scripturi simple pentru a converti textul într-un fișier de aspect al programului InDesign folosit în editură. Nu sunt surprins de asta.

O zi buna, colegi!

După o lungă călătorie de învățare, toată lumea vrea să arate angajatorului roadele lor și să le arate doar din partea cea mai bună, profesională, nu? Cred că da. Prin urmare, pe lângă un proiect corect conceput și implementat, trebuie să putem să-l oficializăm. Angajatorul nu va citi întregul cod al proiectului pentru a înțelege despre ce este vorba și ce este inclus în acesta? În acest articol le vom rezuma în cele din urmă pe cele două anterioare, și anume: și, să înțelegem pe foaia „față” a proiectului open-source ce am folosit în proiectul nostru și ce este. Azi vă vom vorbi despre Markdown, Ne vom pune întrebările noastre preferate: „Ce este asta?” și „De ce este aceasta?”, ne vom da seama unde este folosit și cum să lucrăm cu el. Va fi chiar un exemplu, îl vom implementa în .

Ce este „Markdown”?

Deoarece tu și cu mine suntem programatori, vom merge imediat la Google și vom deschide primul link Wiki care spune: Markdown este un limbaj de marcare ușor creat cu scopul de a scrie cel mai lizibil și ușor de editat text, dar potrivit pentru conversia în limbaje avansate de publicare (HTML, Rich Text și altele). Aici, ca să fiu sincer, nu am multe de adăugat, cred că aceasta este o explicație aproape perfectă.

De ce avem nevoie de acest „Markdown”?

Pentru a fi sincer, nu este rău fără ea: D Dar să ne amintim scopul nostru: să scriem un șablon de proiect competent care are deja Integrare continuă și are statistici de acoperire a codului pe resursa Codecov. De ce am menționat asta? Mai mult, Markdown ne va permite să luăm date din aceste resurse și să furnizăm datele în sine, sau insigne care ne vor redirecționa acolo unde trebuie să obținem aceste informații. Este convenabil să aveți totul pe o singură pagină de „titlu”, mai degrabă decât împrăștiate locuri diferite, nu-i aşa?

Unde este folosit?

Oricine a încărcat oricare dintre proiectele lor în GitHub cel puțin o dată știe că GitHub dorește constant să vă invite să creați un fișier README: Care este extensia acestui fișier? Așa e, Bolt știe Markdown! După cum știm deja, acest fișier este foarte ușor ajustat la multe formate și convertit în HTML de care avem nevoie. Dar haideți să ne luăm timpul și să nu vă grăbiți să îl adăugați imediat direct în GitHub.

Cum să lucrezi cu el?

În primul rând, după cum probabil ați observat, îl putem adăuga direct în GitHub și va funcționa! Dar nu trebuie să-l adăugăm întotdeauna la un singur proiect, de exemplu. Sau, de exemplu, vrem să ne gândim mai mult la modul în care îl creăm. Și aici GitHub nu mai este potrivit pentru noi. Și, în general, putem crea fișiere Markdown nu numai în scopul de a le împinge în GitHub. În al doilea rând, le-am putea crea direct prin IDEA, ceea ce vom face, dar nu imediat, din acest motiv. Aveți nevoie de un mediu de dezvoltare puternic pentru a scrie un fișier mic? Aici vă recomand să vă uitați la catalogul de editori de fișiere Markdown. Pentru mine, am ales Haroopad, este foarte simplu, accesibil și are o reprezentare instantanee scrii (de asemenea IDEA. are) și are un indiciu sub formă de sintaxă Așa arată fereastra editorului: Aici am deschis un README.md gata de unul dintre proiectele mele o foaie de înșelăciune, în dreapta este un afișaj, în centru este totul foarte primitiv și simplu, despre care vom vorbi în curând Cei care aleg un alt mod de a scrie aceste fișiere nu te alarma, tot ce va fi diferit este asta. GUI. Textul, sintaxa și afișarea vor rămâne neschimbate. Exemplu Sarcina este foarte simplă: scrieți README.md astfel încât să conțină: informații despre proiect (inclusiv insigne), informații despre importul proiectului, informații despre implementarea proiectului, informații despre contactele autorului. Totul este foarte simplu și primitiv, așa cum am spus deja. Să trecem la treabă. Link-uri utile
  • Ce ne spune Wiki despre Markdown;
  • Directorul editorilor Markdown;