Arbeta med kodavsnitt

Föreställ dig att du måste skriva ett dokument i Word som är fyllt med text, kulor, bilder, diagram och länkar. Det är redan en handfull layout, eller hur? Någonstans i mitten måste du visa kodändringar som du har gjort i ett projekt, och du har ingen aning om var du ska börja.

Detta kan hända i ett antal situationer. I arbetsinställningar när du förbereder en projektrapport för en klient eller när du skickar in ett test för en jobbansökan. Andra exempel är när du skickar in en artikel för en studie och förbereder en korrespondens med mentorer eller vänner. Så tekniskt har du en känsla av att det kan göras ... men du har aldrig gjort det.

Oooh, titta på alla de konstiga och underbara karaktärerna. Det finns så många av dem, precis som specialtecken i ditt Word-dokument. |

Om du aldrig har behövt kopiera och klistra in din kod i ett Microsoft-dokument, är det bra för dig. Förhoppningsvis behöver du aldrig, i vilket fall allt är bra. Men när du behöver ...

Kom ihåg

Kopiera och klistra in garanterar inte att du behåller kodformateringen som den är!

Problemet med god ol kopia + klistra in

  • Ingen garanti. Kanske fungerar det för dina första en till tre rader med koder, men när du måste kopiera och klistra in 1 000 rader med koder och behålla sin formatering, kan du ha ett problem. Eller inte . Det finns faktiskt inget sätt att berätta, såvida du inte har varit där.
  • Karaktärerna är på sin plats. Det har rapporterats att när du kopierar direkt från ett datorprogram och inte en kodredigerare, så slutar halvkolonierna och de lockiga parenteserna på fel plats.
  • Obekvämt redigering. Okej, så du kanske har lyckats kopiera och klistra in ett kodstycke mitt på sidan. Allt ser bra ut. Men när du börjar redigera vanlig text, kommer dina koder att röra sig och blir förvrängda och kommer i vägen för din redigering. Det kommer att bli nästan omöjligt att redigera någon text alls om din kod är sidor lång.
  • Stylingfrågor. Du kanske måste presentera din kod med en rosa bakgrund. Eller med radnummer eller i vissa typsnitt och med olika färger. Dessa stylingkrav ligger utanför ramen för en enkel kopierings- och klisterteknik.

Vi presenterar ... markören! |

1. Använd en syntaxmarkör

Många användbara verktyg är fritt tillgängliga online. Syntaxmarkören är ett verktyg som visar dina koder i olika färger och teckensnitt, beroende på deras kategorier. Det finns så många markörer tillgängliga, och du kan till och med skapa dina egna på nolltid.

En som jag ofta använder är Planet B Syntax Highlight Code, som är begränsad för följande språk: C, C ++, C #, CSS, Delphi, Pascal, XML, Java, JavaScript, PHP, Python, Ruby, SQL, VB och HTML. Det fungerar i mycket enkla steg:

  1. Kopiera kodblocket från ditt datorprogram;
  2. Klistra in kodutdraget i inmatningsområdet Planet B;
  3. Välj ett språk från rullgardinsmenyn under inmatningsrutan och klicka sedan på knappen "Visa markerad";
  4. Kopiera det resulterande kodavsnittet och klistra in det i ditt dokument ;
  5. Style det. Du kan ändra typsnitt och storlek från Word-inställningen för att få ditt kodavsnitt att se hemma.

Observera att när du använder denna markör kommer det resulterande kodavsnittet automatiskt att ha radnummer, och dessa kan du inte bli av med. Det är bara en standardutgång för textredigeringsfunktionen. Även om detta kan leda till ett mycket trångt kodblock, är syntaxmarkören ett snabbt och enkelt alternativ.

Inmatning

Produktion

I ord

Om du gör en snabb sökning på webben med "gratis online syntaxmarkör" som sökord, hittar du många alternativ till Planet B. Här är några tillgängliga markörer som jag har provat på:

  • ToHTML - Utrustad med en förhandsgranskning av hur utdraget skulle se ut på ett Word-dokument.
  • Hilite.me - Mer än 250 språk att välja mellan.
  • Pine Tools - Stilar automatiskt dina kodavsnitt. Det finns dussintals stilar utöver standard.

Style dina koder och få dem att sticker ut. |

Skapa

Genom att ändra befintliga Word-stilar kan du visa dina kodavsnitt i en specifik stil.

2. Skapa en stil och kalla den "kod"

I Word finns det redan inbyggda stilar och teman för dig att ändra och anpassa efter dina behov. Du kan ändra formateringen av stilen, till exempel teckensnittstorlek, färg, intryck, fyllningsfärg osv. Standardkodblockstil för Word som jag använder är inställt med Consolas, i en något mindre teckensnittstorlek än stycket, med skuggningen inställd på att fylla med ljusgrå och i enstaka avstånd.

Du kan senare ändra denna formatering beroende på din smak. Istället för grått kan du fylla blocket med beige eller ren gul eller din favoritfärg. Lek med det som ser bäst ut för att passa ditt papper.

Kodstil

Så här kan du skapa den stilen:

1. Först måste du kopiera ditt block med kod från datorprogrammet och sedan klistra in det i ditt Word-dokument . Den knepiga delen om att kopiera och klistra in ett block med text från webben är att det vanligtvis kommer att finnas någon slags markering på texten som inte försvinner efter att du klistrar in den. Det du gör för att rensa de oönskade höjdpunkterna från den klistrade texten är att välja hela kodblocket och klicka sedan på Ctrl + Mellanslag . Det skulle bli av med det.

Ctrl + Mellanslag

Ta bort oönskad markering från kopierade texter genom att välja det klistrade kodblocket och sedan klicka på Ctrl + Mellanslag. Ibland är höjdpunkten vit, vilket gör den knappt märkbar.

2. Markera sedan det kodavsnittet i dokumentet och högerklicka sedan på markeringen . Du hittar två dialogrutor öppna. Leta efter ett alternativ "Stilar" och klicka på det.

Markera kodavsnittet och klicka höger.

Välj "Stilar"

3. Det andra steget är att skapa en stil . När du har valt "Styles" i dialogrutan får du ett alternativ till "Skapa en stil". Det är mycket viktigt att veta var man kan hitta alternativet Skapa ett stil, eftersom det inte finns någon annanstans i panelerna.

Välj alternativet "Skapa en stil" från avsnittet Stilar.

4. När du ser formateringsalternativet Ny stil kommer du att kunna ändra stilens namn från standardformatet "Stil 1" till ett nytt namn. Eftersom den här stilen kommer att gälla för bara dina kodavsnitt, låt oss kalla det "kod". Därefter kommer du att ändra din nyskapade stil.

Namnge din stil.
Klicka på knappen "Ändra".

5. När du har klickat på "Ändra" -knappen kommer du att gå till dialogrutan Ändra stil och du börjar anpassa formateringen av din nya stil.

a. Börja med att välja "Paragraf" som din stiltyp.

b. Välj "Normal" för alternativet "Stil baserat på".

c. Om du väljer en "Normal" för "Stilen för följande stycke" kommer du att se till att nästa stycke efter ditt kodavsnitt inte kommer att virka upp.

Anpassa dessa egenskaper.

6. Nästa sak du vill göra är att ändra några andra formateringselement i stilen:

a. Välj ett teckensnitt . Jag brukar använda Consolas för koder, eftersom de ser flexibla och lätta ut på ögonen.

b. Välj en teckenstorlek . De flesta gånger har jag mitt vanliga stycke skrivet i 12 pt-storlek, så jag skulle föreslå ett något mindre teckensnitt för koden, kanske 11 pt eller 10, 5 pt.

c. Välj en teckensnittsfärg . Du kan välja automatisk färg, men det finns många andra alternativ.

I den här dialogrutan får du en förhandsgranskning av hur din stil skulle se ut på sidan. Så innan du använder stilen, se till att titta på förhandsgranskningsrutan och klicka sedan på alternativet "Format".

Gör flera andra formateringsval innan du går vidare till nästa steg.

7. Från Format-alternativet väljer du "Paragraf" och går sedan till Avståndet. Välj "Singel" för ditt linjeavstånd och klicka sedan på OK.

Gör några ändringar i dialogrutan Paragraf.

8. Återigen, från formatalternativet väljer du "Border" . När dialogrutan Gräns ​​öppnas, klicka på fliken "Skuggning" och välj en fyllningsfärg. Du kan välja en av temafärgerna, till exempel den ljusgrå som jag vanligtvis använder som standard. Du kan välja vilken färg du vill. När du har fått rätt skuggningsfyllning för ditt kodval, klicka på OK.

Välj en ljusgrå färg för fyllningen.

9. Tillbaka i dialogrutan Ändra stil väljer du "Format" och navigerar till avsnittet "Ram" . Detta öppnar en ramdialogruta där du väljer "Runt" som din textomslagning. Ändra inte något annat och klicka bara på OK.

Välj en ramtyp.

10. Förhandsvis, förhandsgranska din kodstil och se till att allt ser bra ut. Var försiktig med irriterande ytterligare markering som inte försvinner. Detta händer vanligtvis när du kopierar och klistrar in texter från webben. Om du stöter på det, välj bara ditt kodblock och rensa teckensnittet (se steg 1). Klicka på OK när du är nöjd med hur det ser ut.

Sist men inte minst: kodinsättning. |

3. Använd Infoga> Objekt> Öppna dokumenttext

Den sista metoden använder alternativet Infoga. Även om detta är typ av kopiera och klistra in, kom ihåg att inte kopiera koder direkt från ditt program. Så här gör du:

1. Först bör du göra din kod klar . Du måste klistra in din kod i en kodredigerare och sedan kopiera kodstycket för att klistra in på dokumentet.

2. Välj "Objekt" på fliken "Infoga" längst upp i ditt Word-dokument. Detta öppnar ett dialogfönster.

Gör ett urval.

3. Välj alternativet OpenDocument Text från fliken "Skapa nytt" och klicka sedan på OK. Detta öppnar ett nytt, tomt dokument.

4. Kopiera ditt kodavsnitt från kodredigeraren och klistra sedan in det i det nya tomma Word-dokumentet . När du klistrar in hela blocket sparar du filen och stänger sedan dokumentet.

5. Där har du det. Din kodinföring är rätt där du vill ha den i dokumentet. Du kan nu fortsätta redigera ditt papper och göra nödvändiga justeringar.

Din infogade kod på sidan.

Några frågor att förutse

1. Ändra den normala stilen

Om du har spelat med stilar, till exempel för ditt slutdokument, vet du att det är ganska lätt att ändra en stil från panelen uppe till höger. Detta är ett alternativ, men det är bäst att inte ändra "Normal" -stil, eftersom det är grunden för resten av stilarna.

Eventuella ändringar av den normala stilen kan påverka alla andra stilar. Rubriker, undertexter, citat etc. kan också ändras. Om du bara gör ändringar i teckenstorlek och färg, kanske du inte ens inser att resten av formatmallen också förändras.

Men när du lägger till ett fyllmedel i skuggningen kan hela dokumentet bli grått!

2. Radera en stil

När du tar bort en stil genom att välja "Ta bort från stilgalleriet" försvinner den inte riktigt . Säg att du vill ta bort din kodstil eftersom den inte fungerade korrekt och du vill göra om den. Du tar bort det från galleriet.

När du gör om processen och namnger din stil "Kod" ser du detta meddelande:

Felmeddelande för stilnamn.

För att lösa det här problemet går du bara till dialogrutan Style från galleriet och letar efter den stil du vill ta bort.

Öppna dialogrutan Style.
Hitta den stil du vill ta bort och välj sedan alternativet att ta bort.

3. Använder inte en kodredigerare.

Det är klokt att investera på en kodredigerare tidigt. Det finns många gratis eller delvis gratis kodredigerare, som Sublime Text 3, Atom, Notepad ++ och Code Writer från Microsoft app store.

Den här artikeln är korrekt och sant efter bästa författares kunskap. Innehållet är endast för informations- eller underhållningsändamål och ersätter inte personlig rådgivning eller professionell rådgivning i affärs-, finansiella, juridiska eller tekniska frågor.