Når du vil lære og undervise i kode, kan det være nyttigt at skrive koden i et dokument. Dette er også nyttigt i planlægningsfasen af ​​et projekt. Du tror måske, at du bare lægger kommentarer i koden, men det kan være besværligt, da kommentarer skal vise, hvordan denne kode fungerer. I dokumentet kan du placere projektideer, planlægning og abstrakte ideer, der ikke hører hjemme i kodekommentaren. Dokumentet kan også indeholde resultater af udførelsen, som er stærk til at drage konklusioner, men ikke har nogen plads i den endelige kode.

Kode i Emacs

Mange udviklere bruger Emacs til at udvikle software, det er en kraftfuld kodeditor. Faktisk betragter mange det som en IDE, når de er korrekt konfigureret. Men dokumenter er normalt adskilt fra koden. Hvis du vil demonstrere kode eller planlægge et nyt projekt, kan du bruge kodestykker. For at vise, hvordan du mener, at det skal fungere, kan du skrive et sådant dokument. En effektiv måde at gøre dette på er at oprette et Org-dokument. For at tilføje kode til dit dokument skal du tilføje en kodeblok. En kodeblok er et standardsæt med kode, som du kan se nedenfor.

# + begin_src javascript
const app, BrowserWindow = kræv ('elektron')
const sti = kræver ('sti')
# + slut_src

Resultatet kan gå til dokumentet.

Dette eksempel skaber ikke en output, den enkleste måde at få output på er at bruge shell. Når du vil køre en kommando og vise resultaterne, skal du tilføje en headerparameter.

# + begin_src shell: eksporterer begge dele
uname -a
# + slut_src
uname -a
Linux-måtter-Ubuntu 5.0.0-20-generisk # 21-Ubuntu SMP man 24. juni 09:32:09
UTC 2019 x86_64 x86_64 x86_64 GNU / Linux

Resultatet tilføjes af Emacs i blok under udførelseskoden. Hvis du vil have mere avancerede resultater, eller hvis du vil kombinere blokke, skal du navngive din kildekodeblok. Tilføj det valgfri # + NAME: tag. Dette tag fungerer både for tabeller og kode.

tabel 1.3.1:

x	y	z
0	1	4
1	3	6
2	4	8

Med calc-modulet kan du indsætte data og få resultaterne vist i dokumentet.

# + begin_src calc: var x = 5: var y = 2: eksporterer begge
2 + a * x ** y
# + slut_src

Først vises koden i den form, du angiver. Direkte nedenfor vises resultaterne.

2 + a * x ** y
25 a + 2

Dette er et meget simpelt eksempel, med understøttelse af LaTeX kan du få den formel, du ønsker med resultatet, i et meget godt formateret dokument. EN

\ begin ligning
x = \ sqrt b
\ end ligning

Hvis du producerer plotter med din kode, kan du vise det inde i dokumentet. Nedenfor kan du se en meget enkel kode, der bruger gnuplot til at plotte resultatet af x2.

f (x) = x ** 2
plot f (x)

For at dette skal fungere, skal du have gnuplot installeret på dit system. Disse funktioner kaldes alle fra systemet og præsenteres i Emacs. Det samme gælder for alle programmeringssprog, som Emacs understøtter.

Ikke al kode understøttes uden for boksen

Af hensyn til effektiviteten er ikke alle understøttede sprog aktive i en vaniljeinstallation af Emacs. For at sikre, at du har den aktiv, kan du tilføje kode til din emacs-konfiguration, init.el er standardfilen.

'(org-babel-load-sprog
(citere
((python . t)
(emacs-lisp . t)
(skal . t)
(js . t)
(sqlite . t)
(beregnet . t))))

Ovenstående kode muliggør seks sprog ved at indstille dem til 't'. 't' er den almindelige måde at sige sandt på i Lisp. Du kan også vælge at indstille denne værdi med metoden 'M-x tilpas variabel'. Når du gør dette, skal du indtaste variabelnavnet eller gruppen. I dette tilfælde er variablen 'org-babel-load-languages'. Når du kommer til siden, kan du se, hvad der understøttes, og aktivere dem, du ønsker.

Tilføjelse af et sprog

Hvis dit sprog ikke er på listen, kan du kigge efter sprog på https: // orgmode.org / worg / org-bidrag / babel / sprog.I øjeblikket.html Listen over understøttede sprog er allerede lang og vokser dag for dag. Bemærk her, support til et sprog er kun nødvendig for evalueringen. Visning, eksport og sammenfiltring understøttes uden den. På den nævnte webside har du også bidraget med sprog, der kræver lidt mere arbejde at installere. Hvis du stadig ikke kan se dit sprog, er der en skabelon til at tilføje det selv. Dette kræver nogle lisp programmeringsfærdigheder, men hvis du ser på de andre sprog, skal du kunne tilføje det selv med mindre erfaring.

Konklusion

Denne artikel har kun ridset overfladen af, hvad du kan gøre med org-mode. Flere funktioner er tilgængelige, og at kalde Emacs til en simpel editor gør dig selv en bjørnetjeneste.