Převod souboru PMX do PDF

Lidé převádějí zdrojový kód PMX do PDF, když potřebují notový materiál vhodný k tisku, partituru s pevným rozvržením pro sdílení nebo kopii, kterou lze zobrazit bez toolchainu PMX a MusiXTeX. PDF také poskytuje stabilní archivní verzi, zatímco původní zdrojový kód zůstává upravitelný.

Co je formát PMX

V kontextu dokumentů je PMX textový zdrojový formát pro preprocesor PMX používaný se systémem sazby hudby MusiXTeX. Popisuje noty, rytmy, hlasy, texty písní, nástroje a rozvržení stránky; nejde o hotový obraz stránky ani vyrenderovanou partituru.

Skladatelé, aranžéři a sazeči hudby vytvářejí nebo upravují soubory PMX pomocí nástrojů PMX a textových editorů. Projekt může obsahovat také vygenerované soubory .tex, makra MusiXTeX, hudební fonty, soubory s texty písní a další odkazované zdroje. Přejmenování .pmx na jinou příponu zdroj nepřevede.

Co je formát PDF

PDF ukládá vysázené stránky v pevném rozvržení včetně textu, notového zápisu, mezer a obvykle vložených nebo odkazovaných fontů. Je vhodné k tisku, distribuci notového materiálu, odevzdání partitury a archivaci verze, která nevyžaduje PMX ani MusiXTeX.

PDF není praktickou náhradou zdrojového kódu: změny hudební struktury, textů písní nebo rozvržení jsou podstatně snazší v původním souboru .pmx a jeho souvisejících souborech. Kompletní zdrojový projekt uchovávejte spolu s exportovaným PDF.

Jak převést PMX do PDF

Spolehlivou metodou je lokální sazba s distribucí TeX, MusiXTeX a distribucí PMX. TeX Live podporuje Linux, macOS a Windows; v systému Windows lze použít MiKTeX, pokud jsou k dispozici požadované balíčky MusiXTeX. Samotný PMX může být nutné nainstalovat samostatně z jeho distribuce nebo ze zdroje CTAN.

1. Nainstalujte TeX Live nebo MiKTeX, MusiXTeX a PMX. Ověřte, že pmxab a wrapper command MusiXTeX jsou dostupné v systémové proměnné PATH.
2. Umístěte zdrojový soubor a všechny odkazované soubory do jednoho pracovního adresáře. Zkontrolujte názvy souborů, relativní cesty, vlastní makra, fonty a vloženou grafiku.
3. Otevřete v tomto adresáři terminál a spusťte pmxab score.pmx. Tím se obvykle vygeneruje soubor kompatibilní s MusiXTeX, například score.tex.
4. Spusťte MusiXTeX build wrapper, obvykle musixtex score nebo musixtex score.tex, podle nainstalované distribuce. Wrapper provede průchody TeX a pomocnými soubory potřebné pro rozvržení hudby a obvykle vytvoří score.pdf.
5. Otevřete PDF a zkontrolujte každou stránku včetně rozestupů systémů, textů písní, triol a dalších nepravidelných dělení, posuvek, zalomení stránek, zalomení řádků a koncových taktových čar.

Názvy příkazů a chování wrapperu se mezi verzemi PMX a MusiXTeX liší. Pokud wrapper není k dispozici, použijte postup sestavení dodaný s danou verzí, místo abyste předpokládali, že postačí jedno spuštění pdflatex. Vygenerovaný soubor PMX může vyžadovat tradiční TeX, průchody musixflx a opakované průchody TeX, po nichž následuje generování PDF.

V systému Windows spouštějte příkazy v Command Prompt nebo PowerShell po přidání adresářů TeX, MusiXTeX a PMX do proměnné PATH. Distribuce PMX může také poskytovat dávkový soubor nebo grafický příkaz Build či Typeset.

Možnosti online převodu

Obecné webové stránky pro převod souborů a převodníky kancelářských dokumentů obvykle neumějí analyzovat notaci PMX, takže nejsou spolehlivou možností pro přímé nahrání souboru. Overleaf dokáže zkompilovat projekt MusiXTeX s vygenerovaným souborem .tex, pokud jsou nahrány požadované balíčky a podpůrné soubory, nejde však o přímý převodník PMX, protože krok předzpracování PMX je obecně nutné provést nejprve lokálně. U nezveřejněných partitur nebo projektů obsahujících vlastnický materiál je vhodnější lokální kompilace.

Kvalita a kompatibilita

Výstup závisí na kompatibilních verzích PMX, MusiXTeX, TeX, maker a hudebních fontů. Chybějící balíčky nebo odkazované soubory mohou kompilaci zastavit nebo vytvořit neúplný notový zápis; při diagnostice chyb si ponechte compiler log.

PMX používá strukturovaný zdrojový kód citlivý na syntaxi, nikoli běžný text pro zpracování ve word procesoru. Pokud jsou zalomení stránek nebo mezery nesprávné, změňte příslušná nastavení rozvržení PMX a znovu vygenerujte PDF. Přímé úpravy notového zápisu v PDF mohou změnit umístění, aniž by opravily samotnou hudbu. Uchovávejte původní zdrojový kód a zaznamenejte verze nástrojů použité k vytvoření finálního PDF.