Převod souboru ASM do PDF

Kopie ve formátu PDF umožňuje recenzentům vytisknout nebo archivovat zdrojový kód v assembly bez nutnosti použití assembleru a příjemcům CAD umožňuje prohlédnout assembly v případě, že nemají autorskou aplikaci. Správný postup závisí na tom, zda soubor .asm obsahuje zdrojový kód procesoru, nebo CAD assembly.

Co je formát ASM

.asm je nejednoznačná přípona. V softwarových projektech obvykle označuje zdrojový kód v assembly v prostém textu pro procesory, jako jsou x86, ARM, MIPS, 8051 nebo 6502. Tyto soubory mohou vytvářet MASM, NASM, GNU assembler, Keil, MPLAB a IDE pro embedded systémy. Mohou obsahovat instrukce, návěští, direktivy, makra, komentáře a příkazy include.

V mechanickém CAD může .asm označovat dokument assembly, zejména v Solid Edge. CAD assembly obvykle odkazuje na samostatné soubory dílů a podsestav; nejde o dokument v prostém textu a nelze jej správně převést pouhým přejmenováním přípony nebo odesláním do převodníku textu na PDF.

Co je formát PDF

PDF ukládá stránkovanou vizuální reprezentaci s fonty, umístěním, grafikou a nastavením tisku. Je vhodný pro výpisy kódu, technickou dokumentaci, kopie určené k revizi a archivní snímky, ale nekompiluje zdrojový kód v assembly ani nezachovává nativní upravitelnost CAD assembly, parametrickou historii nebo úplnou strukturu komponent.

Převod zdrojového kódu v assembly v systému Windows

1. Otevřete soubor .asm v aplikaci Notepad++, Visual Studio Code nebo jiném textovém editoru. Neotevírejte jej v textovém procesoru, který může nahradit tabulátory nebo změnit znaky.
2. Pokud požadujete obarvení syntaxe, vyberte odpovídající lexer pro assembly. V Notepad++ použijte Language → A → Assembly; obarvení je pouze vizuální a nekontroluje syntaxi ani neurčuje dialekt procesoru.
3. Použijte neproporcionální font, například Consolas nebo DejaVu Sans Mono. Nastavte řádkování, okraje, orientaci a velikost fontu tak, aby nedocházelo k zalamování důležitých instrukcí.
4. Vyberte File → Print, zvolte Microsoft Print to PDF a v možnostech tisku nastavte velikost papíru, orientaci, okraje, čísla řádků a zvýraznění syntaxe. Uložte výsledný PDF soubor.

Pro PDF obsahující pouze kód je vhodnější příkaz tisku v editoru než kopírování zdrojového kódu do textového procesoru, protože spolehlivěji zachová odsazení a strukturu řádků.

Vytváření opakovaně použitelných PDF se zvýrazněním na libovolné desktopové platformě

Pygments může vytvořit HTML zobrazení, které prohlížeč vytiskne do PDF. Nainstalujte jej pomocí:

python -m pip install Pygments

Pro syntaxi NASM spusťte:

pygmentize -l nasm -f html -O full,style=default -o program.html program.asm

Pro syntaxi GNU assembleru použijte -l gas; pokud to dialekt vyžaduje, vyberte jiný lexer Pygments. Otevřete program.html v prohlížeči a zvolte Print → Save as PDF. Použijte neproporcionální font, orientaci na šířku, úzké okraje a vhodné měřítko pro dlouhé řádky. Tím se zdrojový kód vykreslí; nedojde k jeho sestavení ani ověření.

Převod Solid Edge nebo jiné CAD assembly

1. Otevřete assembly v nativní CAD aplikaci a před exportem vyřešte chybějící odkazy na díly, podsestavy, materiály a textury.
2. Použijte příkaz Solid Edge Publish 3D PDF, pokud je dostupný v nainstalované edici a licenci, a poté vyberte požadovaná zobrazení, vlastnosti modelu, PMI a strukturu assembly. Názvy příkazů a dostupnost 3D PDF se v jednotlivých edicích liší.
3. Pokud místo toho potřebujete plochý technický dokument, vytvořte nebo otevřete výkres a pomocí File → Export nebo Print vytvořte 2D PDF. Výsledkem budou výkresové listy, nikoli interaktivní 3D model.
4. Otevřete výsledek v desktopovém prohlížeči PDF, který podporuje vložený 3D obsah. Mnoho prohlížečů PDF v prohlížečích a mobilních aplikacích zobrazuje pouze stránku nebo vynechává interaktivní 3D funkce.

Jiné CAD systémy mohou publikovat 3D PDF přímo nebo vyžadovat exporter či translator. Obecný online převodník není spolehlivou náhradou, protože může ignorovat odkazy assembly, potlačit komponenty nebo podporovat pouze 2D výkresy.

Online převodníky

CloudConvert a Online-Convert mohou být užitečné pro převod prostého textu do PDF, pokud služba výslovně přijímá nahrávaný soubor nebo dočasnou kopii .txt. Před sdílením výsledku ověřte typ vstupu, kódování, rozvržení stránky a vygenerovaný text. Online služby obvykle nepodporují Solid Edge assembly ani export interaktivního 3D PDF.

Nenahrávejte proprietární firmware, přihlašovací údaje, výzkum exploitů, nezveřejněný zdrojový kód ani důvěrná CAD data, pokud nejsou podmínky uchovávání a zpracování dané služby přijatelné. Lokální export z editoru, prohlížeče nebo nativní CAD aplikace tomuto vystavení zabrání.

Omezení kvality a kompatibility

Převod do PDF neřeší include soubory, nerozbalí makra, neodhalí chyby assembleru, nezachová nastavení buildu ani nereprodukuje spustitelný výstup programu. Před tiskem otevřete zdrojový kód s použitím jeho skutečného kódování, obvykle UTF-8; nesprávné kódování může nahradit komentáře obsahující znaky mimo ASCII. Ve výsledném PDF zkontrolujte dlouhé řádky, tabulátory, čísla řádků, zalomení stránek, symboly a barvy syntaxe.

Uchovejte původní soubor .asm a související soubory projektu nebo CAD komponent. Extrakce textu z PDF může změnit tabulátory, mezery, konce řádků a pořadí čtení, zatímco 3D PDF může vynechat nepodporované CAD funkce. U archivních kopií zaznamenejte procesor, assembler a jeho verzi, kódování zdrojového kódu, CAD aplikaci a její verzi, pokud je to relevantní, nastavení exportu a datum převodu.