Hur man enkelt skapar Markdown med TextSoap

TextSoap är ett ovärderligt verktyg som jag tycker allt mer användbart. Det levereras med speciella textrenare - små rutiner för behandling av text.

I denna handledning introducerar jag TextSoap och skapar en anpassad textrenare för att behandla en artikel som skrivs i Markdown för att göra den redo för att lägga till WordPress.


Användningsfallet

När jag skriver, tycker jag om att se orden. När du skriver på webben behöver du ofta en typ av markering för att ställa in din text. Lyckligtvis finns det Markdown för att markera texten, men inte gömma texten.

Många innehållshanteringssystem, eller CMS, som WordPress, accepterar inte markdown direkt. Därför finns det många översättningar, tillägg och andra uppgifter som krävs för att texten ska kunna publiceras. Det kan vara en tidskrävande röra. Särskilt om du måste göra det ofta.

Samtidigt som jag arbetade på vissa artiklar, för Tuts +, bestämde jag mig för att automatisera textomvandlingsprocessen. Det är där kraften i TextSoap verkligen lyser.


Komma igång

När du startar TextSoap kommer du att presenteras med huvudskärmen.

Den innehåller arbetsområdet till vänster och listan över textrenare till höger. Om du redan har saker på ditt urklipp kommer den automatiskt att placeras i arbetsområdet.


TextSoap huvudfönster

tryck på Redigera rengöringsmedel för att öppna den anpassade rengöringsredigeraren. Det här är arbetsområdet för att skapa en anpassad rengöringsmedel. Det kommer att visa innehållet i den senast redigerade rengöraren. Som du kan se har jag många anpassade städare.


TextSoap Edit Custom Cleaner-fönstret

Tryck på + knappen längst ned till vänster skapar en ny rengörare. Namnge det Markdown till artikel. Nästa steg är att skapa renare. Mittområdet är listan över clearners som ska tillämpas. Det är för tillfället tomt, men inte för länge. Den högra sidan har alla tillgängliga åtgärder som du kan lägga till renaren.


Skapa en ny rengörare

Du kan lägga till en handling genom att dra en från listan till höger till vart du vill ha den i mitten. Varje åtgärd som placeras i mittområdet appliceras en i taget från början av skärmen till botten. Därför går det faktiskt helt igenom hela texten varje gång det behandlar ett block i renaren.

Det gula området under det mellersta arbetsområdet är att lägga till kommentarer. När du lägger till en städare i mittområdet kan du lägga till en mer läsbar beskrivning av vad du gör med den städaren. Detta gör det enklare att följa städaren och redigera den i framtiden!

Eftersom varje block går igenom varje textlinje som ska behandlas, desto mer block du använder i din renare, desto längre kommer rengöringsprocessen att ta. Därför är det bäst att hålla antalet block till det lägsta som krävs.


tillsats Prissänkning Rengöringsmedel

Det första du måste göra är att konvertera markdown-texten till HTML. Titta på listan över städare på höger sida. Längre ovanför listan är en sökruta. Typ markera och en renare kommer att dyka upp Markdown Text. Dra den in i mittområdet. Det gör det för att konvertera från Markdown till HTML.

Den städaren producerar tyvärr inte det exakta formatet av HTML som behövs. Det är vad resten av städaren ska göra.


Ta bort HTML-avsnittet Taggar

Eftersom WordPress inte vill att du ska lägga in styckemärken måste de tas bort. Dra Regex Sök och ersätt text renare till mitten strax efter Markdown Text blockera. I den första textrutan placerar du vad som söks: \<[/]*p\>. Detta är ett vanligt uttryck för att detektera en öppnings- eller stängningsflagg. Den andra textrutan är vad du ska ersätta matchande strängen. Låt det vara tomt för att radera taggarna.

Tips: Om du inte är säker på regelbundna uttryck, läs av Du vet inget om regelbundna uttryck: En komplett guide.

Varje Regex Sök och ersätt block måste ställas in för att ignorera fallet. Klicka därför på alternativ knapp och kontroll ignorera fall. Du kommer att se en jag placeras strax efter knappen.


Lägga till klasser i figurer

Därefter måste alla siffror ha den handledning-bild klass i samband med det. Så, få en annan Regex Sök och ersätt text och placera den under den sista. I den första textrutan, placera \ . I det andra textblocket, placera

. Glöm inte att ignorera fallet inställningen!


Fäst H2-taggar: Lägg till
tagg innan

Skriftstandarden för Tuts + är att ha a


tagga före varje rubrik. För att göra detta måste du lägga till en annan Regex Sök och ersätt text blockera med sökrutan som innehåller ( och ersätt textrutan som innehåller
$ 1
. Detta kommer helt enkelt söka efter varje

taggen framför den.


Fäst H2-taggar: Ta bort ids

Markdown-konverteraren kommer alltid att lägga en ID-tagg i rubrikens tagg. Men standarden säger inga ID! De måste gå. Återigen, få en Regex Sök och ersätt text blockera med ] *> i söktextfältet och

i ersättningsfältet. Detta kommer att söka efter varje

taggar oavsett vad som är i mitten och ersätt det med bara en slätt

märka.


Åtgärda bildkällaadressen

När du laddar upp bilder i WordPress placerar den dem alltid i en specifik katalogplats, ett fyrsiffrig år och en tvåsiffrig månad före namnet på den faktiska filen. Eftersom det alltid finns en förutsägbar plats kan en sökning och ersättning användas för att ställa in det här. Innan du gör textrengöringen, se till att du anger år och månad på lämpligt sätt när du laddar upp bilderna för artikeln.

Denna gång, placera a Hitta och ersätt text i mellansektionen med det första textfältet som innehåller . Detta hittar i grunden en bildtagg och ersätter allt innan filnamnet med den korrekta webbvägen till filen.

Det finns ett problem med denna implementering: månaden och året måste ändras varje gång månaden och / eller året ändras för dina artiklar. Eftersom TextSoap inte har ett dynamiskt minnesystem måste det ändras manuellt varje gång.


Fixing Misc. Ankaretiketter

När du har en ankare tagg för att ladda ner något laddat från mediaområdet i WordPress, måste du också korrigera de här adresserna. Därför bara repetera det föregående Hitta och ersätt text blockera med det första textområdet som innehåller \ och det andra textområdet innehåller .


titlar

Det sista som behöver fixas är titlarna. Tuts + kräver att alla titlar är titelfaserade. Men inte alla titelfall är desamma. Det finns en liten webapp för att göra rubrikhuvudet utformat speciellt för Tuts + artiklar. Att granska JavaScript-koden avslöjar att det är önskvärt att följande ord alltid är små bokstäver: a, en, och, liksom, men, för, om, i, på, eller, till, vs, vs, och via. Förutom när någon av dessa är det första ordet i en titel, måste det aktiveras.


Fixing Title Case: Regular Expression

Välj en Om text matchar blockera och dra det till mitten som ovan. Lägg i den här ordinarie uttryckssträngen i textrutan \\> (.) \<\/h2\>. Detta kommer att matcha alla tagg och passera den till nästa block. Det kommer att göra detta för varje linje som matchar. Ställ in Matchinspelningsgrupp: till $ 1. Det kommer bara att skicka texten inuti taggarna till rengöraren (-erna) inuti kvarteret och sätta resultaten tillbaka mellan huvudkoderna. Det är mycket jobbat enkelt! Kom ihåg att ställa in alternativen för att ignorera fallet.

Ta sedan en Titelfall med alternativ blockera och dra det till mitten mellan Om text matchar blockera och avsluta villkorat blockera. Eftersom standardlistan för att göra små är densamma som webben, behöver ingenting läggas till. Bäst av allt är det smart nog att se till att det första ordet alltid aktiveras, oavsett vilket ord det är. Om ett annat ord måste vara små bokstäver, kan det läggas till i den stora textrutan under Standard: a, ... . Om du vill ange några akronymer för att inte ändras kan du placera dem i den andra stora textrutan under Standard: AT & T ... . Jag har lagt till HTML CSS PHP eftersom de alltid ska vara helt stora.

De Behandla: vs vs v v. Som små ord måste kontrolleras.


Sammanfattning

Nu har du en TextSoap-rengörare som tar någon Markdown-text och konverterar den till HTML som kan klistra in direkt i WordPress för publicering. Inga fler justeringar behövs. Det är nu lätt att bara arbeta i Markdown och klistra in det i WordPress bara för att publicera.

Till exempel skrev jag denna artikel i Sublime Text med Markdown, kopierade texten till Urklipp, använde mitt TextSoap Alfred-arbetsflöde för att köra den här renaren för att konvertera Markdown till HTML i Urklipp, klistrade in i WordPress och laddade upp mina bilder. Det är så enkelt!

Ett försiktighetsord: klistra in din HTML i Text fliken i WordPress-redigeraren!

Har du skapat några unika TextSoap rengöringsmedel? Låt mig veta i kommentarerna!