Ако сте софтуерен инженер , вероятно сте отделили много време за усъвършенстване на средата си, за да повишите производителността си. Имате любимата си IDE. Имате любимия си дебъгер. Имате любимия си инструмент за наблюдение на ефективността. Но какво ще кажете за вашия инструмент за писане на документация, ръководства и отчети? В крайна сметка писането отнема нетривиално време, нали? Всъщност е време да се заемете сериозно с инструмента си за писане.
И нека запомним това вие сте техничен , така че редакторите на WYSIWYG може и да не са най-добрият вариант за вас. Не е задължително да искате (или дори да харесвате!) Навигационни менюта, ленти с инструменти и ленти, за да форматирате текста си.
И какво, ако вместо това можете лесно да добавите всичките си стилове за форматиране директно в текста като прост вграден синтаксис, за да получите напълно форматиран текст?
Е, всъщност можете. Това е Маркдаун и това е всичко за този урок.
Когато повече е по-малко ...
Софтуерът за текстообработка е написан, за да задоволи изключително широк кръг потребители и случаи на употреба и като такъв трябва да предоставя всякакви функционалности. Но ясно е, че само малка част от тази функционалност вероятно ще бъде от значение за всеки отделен потребител. И за повечето потребители, които просто искат да създадат документ (и не е необходимо да проектират маркетингова брошура или плакат), много малка част от многото, много налични опции са от значение.
Всъщност Microsoft ясно осъзна това преди няколко години, когато преработи потребителския интерфейс на Microsoft Word в отделни функционални групи, наречени „ленти“. И все пак интересното е, че повечето потребители ще ви кажат, че са намерили новия интерфейс за по-объркващ и труден за навигация от своя предшественик.
номера на карти, които работят през 2017 г
Всъщност понякога повече може да бъде по-малко, когато става въпрос за лекота на използване и производителност.
... и когато по-малкото е повече
Приемете се, вие сте софтуерен инженер, а не графичен дизайнер. Просто искате да напишете това ръководство или технически документ или доклад и да приключите с него. Ще бъдете много щастливи и доволни от някои основни възможности за форматиране, като заглавия, списъци с надписи или номериране и кодови блокове. И, о, да, някои форматиране на шрифтове (получер, курсив и т.н.) също биха били полезни. Това е всичко. (И човече, ако можеш дори просто да го направиш ние , това наистина би било страхотно!)
Въведете Markdown.
Какво е Markdown?
Джон Грубер (със значителен принос от техническия гуру и интернет активист Аарон Суорц ) създаде езика Markdown през 2004 г. с целта на даването на възможност на хората „да пишат, използвайки лесен за четене, лесен за писане формат на обикновен текст и по желание да го конвертират в структурно валиден XHTML (или HTML)“.
Markdown е проектиран да се чете такъв, какъвто е, без да изглежда, че е маркиран с тагове или инструкции за форматиране (за разлика от текст, форматиран с език за маркиране като RTF или HTML, който може да бъде труден за писане и труден за четене в суров формат ).
Markdown ви позволява да пишете, използвайки лесен за четене, лесен за писане формат на обикновен текст, който след това може да бъде преобразуван в структурно валиден HTML. Така че, за да бъдем напълно точни, Маркдаун е наистина две неща :
- Синтаксис за форматиране на обикновен текст
- Софтуерен инструмент (чиято първа версия е написана на Perl), който преобразува форматирането на обикновен текст в HTML.
Markdown включва шепа прости, доста интуитивни и лесни за използване синтаксисни конвенции. Специално за вас като софтуерен инженер - който не се отклонява от необходимостта да научи и използва тези основни синтаксисни конвенции - Markdown наистина може да бъде пътят на най-малкото съпротивление между това, което искате да напишете, и да го напишете.
Научете Markdown: Първи стъпки
Markdown е лесен за научаване. Супер лесно. Можете да научите основите за пет минути и това бързо ще стане втора природа. И - точно както връзката между CSS и CSS препроцесорите - можете да използвате колкото малко или колкото искате.
Ако сте свикнали с някакви конвенции за писане на обикновен текст, тогава може би вече сте запознати с някои конвенции за маркиране, като числа или тирета в началото на изречението, за да създадете списък, звездички около дума за ударение и т.н. На. Така например, ако искате да покажете нещо в курсив, просто го увийте със звездички като *this* (за разлика от по-тромавия HTML синтаксис като this).
какво е единичен тест
По същия начин можете да посочите заглавие H1, като просто добавите префикс „#“ към вашия ред (например Initiate Използвайки идентификатора на нашия контейнер, можем да инициираме За по-нататъшна помощ за започване на работа има много онлайн уроци за Markdown, които ще ви помогнат да получите най-бързата, включително a Преглед на надценката от Джон Грубер (създателят на Markdown), както и онлайн Маркдаун урок . След като напишете статията си в Markdown, ще ви е необходимо приложение, за да анализирате синтаксиса в HTML. Има няколко страхотни такива Безплатно включително: Някои основни платформи вече са приели (или поне разрешили) използването на Markdown в своите редактори за тези, които желаят да го използват. С други, като WordPress, Evernote и Google Docs, родната поддръжка (към момента на писане на тази статия) все още не е изпечена, но потребителски решения са въведени от трети страни. Те включват: Разбира се, с голяма простота идват и ограничения. Както вече обясних, Markdown не е написан за сложни текстообработващи задачи, изискващи разширени функции за форматиране. Ако това е, което ви трябва, Markdown не е правилният инструмент. Но за разработчиците, които трябва да напишат ръководство на потребителя или техническа документация или технически доклад, Markdown осигурява почти перфектен баланс между простотата и характеристиките, от които се нуждаете. Може би най-големият недостатък - особено за нас, инженерите, които сме наркомани за контрол на промените, е невъзможността да го направим работят съвместно в Markdown и за проследяване на промени (едно забележително изключение от това обаче е StackEdit плъгин за Google Docs). И разбира се, с минимално количество усилия, човек може просто да си сътрудничи върху документ Markdown чрез git хранилище и по този начин да получи всички проследяване на промени и сътрудничество, от които обикновено се нуждае. И ученето на Markdown за всички ли е? Разбира се, че не. Никой инструмент никога не е. Но ако сте софтуерен инженер, това може да е точно инструментът за писане, който сте търсили. Така че, ако все още не сте опитали, наистина трябва да го вземете за завъртане.# Section Heading, вместо # Initiating Plugins pluginName на контейнера си, използвайки jQuery, както следва:Инициирайте `pluginName` на вашия контейнер, използвайки jQuery, както следва:
$(function() { $('#container').pluginName(); }); `$ (function () {$ ('# container'). pluginName ();});` pluginName с метода jQuery .pluginName() * Използвайки идентификатора на нашия контейнер, можем да инициираме `pluginName` с метода jQuery` .pluginName () `. * Синтактични анализатори и инструменти
Недостатъците
кое от следните е отговорен финансов директор?
Заключение
