glilypond(1)

glilypond(1)

NAMN

glilypond – bädda in musikalisk notation från LilyPond i groff-dokument

SYNOPSIS

glilypond [-k] [{--ly2eps|--pdf2eps}] [-e katalog] [-o utdatafil]
          [-p filnamnsprefix] [-t tempkatalog] [{-v|-V}] [--]
          [fil ...]

glilypond [{--ly2eps|--pdf2eps}] [--eps_dir katalog]
          [--keep_all] [--output utdatafil] [--prefix filnamnsprefix]
          [--temp_dir tempkatalog] [--verbose] [--] [fil ...]

glilypond -?
glilypond -h
glilypond --help
glilypond --usage

glilypond -l
glilypond --license

glilypond --version

BESKRIVNING

glilypond är en groff(7)-förprocessor som gör det möjligt att bädda in musiknoter från LilyPond i groff-dokument. Om inga operander anges, eller om fil är -, läser glilypond från standard in. Ett argument med dubbla bindestreck (--) gör att alla efterföljande argument tolkas som fil-operander, även om deras namn börjar med bindestreck.

ANVÄNDNING

För närvarande fungerar glilypond med groff-enheterna ps, dvi, html och xhtml. Enheterna lbp och lj4 är inte testade. Tyvärr fungerar enheten pdf ännu inte.

ÖVERSIKT AV FLAGGOR

-? | -h | --help | --usage

Visa användningsinformation och avsluta.

--version

Visa versionsinformation och avsluta.

-l | --license

Visa information om upphovsrättslicens och avsluta.

Flaggor för att bygga EPS-filer

--ly2eps

Instruera lilypond(1) att skapa Encapsulated PostScript-filer (EPS). Detta är standard.

--pdf2eps

Programmet glilypond genererar först en PDF-fil med hjälp av lilypond. Därefter genereras EPS-filen med pdf2ps och ps2eps.

Kataloger och filer

-e | --eps_dir katalognamn

Normalt skickas alla EPS-filer till den temporära katalogen. Med denna flagga kan du ange en egen katalog dit alla användbara EPS-filer skickas. Då kan den temporära katalogen tas bort i slutet.

-p | --prefix början-av-namn

Normalt får alla temporära filer namn som börjar med prefixet ly... Med denna flagga kan du fritt ändra detta prefix.

-k | --keep_all

Normalt tas alla temporära filer bort utom EPS-filerna. Med denna flagga behålls alla genererade filer, både från lilypond och från andra formatomvandlare.

-t | --temp_dir katalog

Med denna flagga anger du en katalog som ska vara bas för den temporära katalogen. Detta katalognamn används som det är utan tillägg. Om katalogen inte finns skapas den. Den temporära katalogen skapas med Perls säkerhetsmekanismer direkt under denna katalog. I den temporära katalogen lagras de temporära filerna.

Utdata

-o | --output filnamn

Normalt skickas all groff-utdata från detta program till STDOUT. Med denna flagga kan det ändras så att utdatan lagras i en fil med namnet filnamn.

-v | -V | --verbose

Mycket mer information skickas till STDERR.

Samlingar av korta flaggor

Argumenthanteringen för flaggor:

Korta flaggor är argument som börjar med ett enkelt bindestreck -. Ett sådant argument kan bestå av godtyckligt många flaggor utan argument, sammansatta som en samling av flaggtecken efter det enkla bindestrecket.

En sådan samling kan avslutas med ett flaggtecken som förväntar sig ett flaggargument. Om detta flaggtecken inte är det sista tecknet i argumentet, är den följande avslutande delen av argumentet flaggargumentet. Om det är sista tecknet i argumentet, tas nästa argument som flaggargument.

Detta är standard för POSIX och GNU-hantering av flaggor.

Till exempel,

-kVe någon_katalog

är en samling av de korta flaggorna -k och -V utan flaggargument, följt av den korta flaggan -e med ett flaggargument som är den följande delen av argumentet någon_katalog. Detta argument skulle alltså också kunna skrivas som flera argument: -k -V -e någon_katalog.

Hantering av långa flaggor

Argument som börjar med dubbla bindestreck -- kallas långa flaggor. Varje argument med dubbla bindestreck kan bara innehålla en enda lång flagga.

Långa flaggor kan ha eller inte ha ett flaggargument. Ett flaggargument kan vara nästa argument eller läggas till med ett likhetstecken = i samma argument som den långa flaggan.

--help är en lång flagga utan något argument.

--eps_dir någon_katalog
--eps_dir= någon_katalog

är den långa flaggan --eps_dir med flaggargumentet någon_katalog.

Dessutom tillåter programmet förkortningar av långa flaggor, så långt det är möjligt.

Den långa flaggan --keep_all kan förkortas från --keep_al ända till --k eftersom programmet inte har någon annan lång flagga vars namn börjar med tecknet k.

Däremot kan flaggan --version inte förkortas längre än till --vers, eftersom det också finns den långa flaggan --verbose, som kan förkortas till --verb.

Ett flaggargument kan också läggas till en förkortning. Så är

--e= någon_katalog

samma sak som

--eps_dir någon_katalog

Dessutom tillåter programmet godtycklig användning av versaler och gemener i flaggnamnet. Detta är Perl-stil.

Till exempel kan den långa flaggan --keep_all lika gärna skrivas som --Keep_All eller till och med som en förkortning som --KeE.

LILYPOND-REGIONER I ROFF-INDATA

Integrerad LilyPond-kod

En lilypond-del i en struktur skriven i groff-språket är hela delen mellan markeringarna

.lilypond start

och

.lilypond end

En groff-indata kan innehålla flera sådana lilypond-delar.

När en sådan lilypond-del mellan .lilypond start och .lilypond end bearbetas säger man att programmet glilypond är i lilypond-läge.

Dessa lilypond-delar skickas till temporära lilypond-filer med filändelsen .ly. Dessa filer omvandlas senare till EPS-filer.

Inkludering av .ly-filer

En extra kommandorad för filinkludering av lilypond-filer ges av

.lilypond include filnamn

i groff-indata. För varje sådant include-kommando kan en fil med lilypond-kod inkluderas i groff-koden. Godtyckligt många av dessa kommandon kan förekomma i groff-indatan.

Dessa include-kommandon får bara användas utanför lilypond-delarna. Inom lilypond-läge är denna inkludering inte möjlig. Alltså får .lilypond include inte användas i lilypond-läge, det vill säga mellan .lilypond start och .lilypond end. Dessa inkluderade ly-filer omvandlas också till EPS-filer.

GENERERADE FILER

Genom omvandlingsprocessen från lilypond-delar till EPS-filer genereras många filer. Som standard betraktas dessa filer som temporära filer och lagras därför i en temporär katalog.

Denna process kan ändras med kommandoradsflaggor.

Kommandoradsflaggor för kataloger

Den temporära katalogen för detta program skapas antingen automatiskt eller kan namnges med flaggan -t | --temp_dir katalog.

Dessutom kan de EPS-filer som senare refereras av kommandot .PSPIC i den slutliga groff-utdatan lagras i en annan katalog, som kan sättas med kommandoradsflaggan -e | --eps_dir katalognamn. Med denna flagga kan den temporära katalogen tas bort helt i slutet av programmet.

Början av namnen på de temporära filerna kan sättas med kommandoradsflaggorna -p eller --prefix.

Alla temporära filer utom EPS-filerna tas till slut bort. Detta kan ändras genom att sätta kommandoradsflaggorna -k eller --keep_files. Då behålls alla temporära filer och kataloger, de tas alltså inte bort.

Dessa EPS-filer lagras i en temporär katalog eller i en EPS-katalog. Men de kan inte tas bort av omvandlingsprocessen eftersom de behövs för visning, vilket kan ta lång tid.

OMVANDLINGSPROCESSER FÖR ATT GENERERA EPS-FILER

Läge pdf2eps

Detta läge är det nuvarande standardläget och kan också väljas med flaggan --pdf2eps.

I detta läge omvandlas .ly-filerna av programmet lilypond(1) till PDF-filer med hjälp av

lilypond --pdf --output= filnamn

för varje .ly-fil. filnamn måste anges utan ändelsen .pdf. Genom denna process genereras en fil filnamn.pdf.

Nästa steg är att omvandla dessa PDF-filer till en PS-fil. Detta görs av programmet pdf2ps(1) med

$ pdf2ps filnamn.pdf filnamn.ps

Nästa steg skapar en EPS-fil från PS-filen. Detta görs av programmet ps2eps(1) med

$ ps2eps filnamn.ps

Därmed skapas en fil filnamn.eps för varje lilypond-del i groff-filen eller standard in.

Det sista steget är att ersätta alla lilypond-delar med groff-kommandot

.PSPIC filnamn.eps

Läge ly2eps

Tidigare var detta standardläget. Nu fungerar det dock inte längre, så acceptera det nya standardläget pdf2eps. För testning kan detta läge också väljas med flaggan --ly2eps.

I detta läge omvandlas .ly-filerna av programmet lilypond till många filer i olika format, inklusive EPS-filer, med hjälp av

$ lilypond --ps -dbackend=eps -dgs-load-fonts --output= filnamn

för varje .ly-fil. Utdatafilnamnet filnamn måste anges utan filändelse, och dess katalog är temporär.

Det skapas många EPS-filer. En av dem innehåller hela den omvandlade ly-filen och heter filnamn.eps.

Dessutom skapas EPS-filer för varje sida, med namnformen

filnamn- siffra .eps

Det sista steget är att ersätta alla lilypond-delar med samlingen av motsvarande EPS-sidfiler. Detta görs med groff-kommandon av typen

.PSPIC filnamn- siffra .eps

GENERERAD GROFF-UTDATA

Den nya groff(7)-struktur som genereras av glilypond skickas antingen

1. till standard ut och kan där sparas i en fil eller pipas till groff(1), eller
2. lagras i en fil genom att ange flaggan -o | --output filnamn

FÖRFATTARE

glilypond skrevs av Bernd Warken ⟨groff-bernd.warken-72@web.de⟩.

SE ÄVEN

groff(1)

beskriver användningen av kommandot groff och innehåller hänvisningar till vidare dokumentation om groff-systemet.

groff_tmac(5)

beskriver begäran .PSPIC.

lilypond(1)

beskriver kort kommandot lilypond och innehåller hänvisningar till vidare dokumentation.

pdf2ps(1)

omvandlar en PDF-fil till PostScript-format.

ps2eps(1)

omvandlar en PS-fil till EPS-format.

KOLOFON

Denna sida är en del av projektet groff (GNU troff). Information om projektet finns på:

• http://www.gnu.org/software/groff/

Om du har en felrapport för denna manualsida, se:

• http://www.gnu.org/software/groff/

Denna sida hämtades från tar-arkivet groff-1.23.0.tar.gz, hämtat från:

• https://ftp.gnu.org/gnu/groff/

den 2026-01-16.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du tror att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar till informationen i detta KOLOFON (som inte är en del av den ursprungliga manualsidan), skicka e-post till:

man-pages@man7.org

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/glilypond.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till PC Service som har sponsrat Linux.se med webbhotell.