Konversi ASM menjadi PDF

Salinan PDF memungkinkan reviewer mencetak atau mengarsipkan source assembly-language tanpa memerlukan assembler, dan memungkinkan penerima CAD memeriksa assembly ketika mereka tidak memiliki aplikasi pembuatnya. Prosedur yang tepat bergantung pada apakah .asm berisi source code processor atau assembly CAD.

Apa itu format ASM

.asm adalah ekstensi yang ambigu. Dalam proyek software, ekstensi ini biasanya mengidentifikasi source assembly-language berupa plain-text untuk processor seperti x86, ARM, MIPS, 8051, atau 6502. MASM, NASM, GNU assembler, Keil, MPLAB, dan IDE embedded-system dapat membuat file-file ini. File tersebut dapat berisi instruksi, label, directive, macro, comment, dan statement include.

Dalam mechanical CAD, .asm dapat mengidentifikasi dokumen assembly, terutama dalam Solid Edge. Assembly CAD biasanya mereferensikan file part dan subassembly terpisah; file tersebut bukan dokumen plain-text dan tidak dapat dikonversi dengan benar hanya dengan mengganti nama ekstensi atau mengirimkannya ke text-to-PDF converter.

Apa itu format PDF

PDF menyimpan representasi visual berpaginasi dengan font, positioning, grafik, dan pengaturan pencetakan. Format ini cocok untuk code listing, technical documentation, salinan untuk review, dan snapshot arsip, tetapi tidak meng-compile source assembly serta tidak mempertahankan editability native, parametric history, atau complete component structure dari assembly CAD.

Mengonversi source assembly-language di Windows

1. Buka file .asm di Notepad++, Visual Studio Code, atau text editor lainnya. Jangan membukanya di word processor yang mungkin mengganti tab atau mengubah karakter.
2. Pilih assembly-language lexer yang paling sesuai jika syntax coloring diinginkan. Di Notepad++, gunakan Language → A → Assembly; pewarnaan ini bersifat visual dan tidak memeriksa syntax atau mengidentifikasi processor dialect.
3. Gunakan monospace font seperti Consolas atau DejaVu Sans Mono. Atur line spacing, margin, orientation, dan font size yang mencegah instruksi penting ter-wrap.
4. Pilih File → Print, pilih Microsoft Print to PDF, lalu atur paper size, orientation, margin, line number, dan syntax highlighting dalam print options. Simpan PDF yang dihasilkan.

Untuk PDF yang hanya berisi code, print command dari editor lebih disarankan daripada menyalin source ke word processor karena lebih andal dalam mempertahankan indentation dan line structure.

Membuat PDF dengan highlighting yang dapat diulang di platform desktop apa pun

Pygments dapat membuat rendering HTML yang kemudian dicetak oleh browser ke PDF. Install dengan:

python -m pip install Pygments

Untuk syntax NASM, jalankan:

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

Untuk syntax GNU assembler, gunakan -l gas; pilih Pygments lexer lain jika dialect memerlukannya. Buka program.html di browser dan pilih Print → Save as PDF. Gunakan monospace font, landscape orientation, margin sempit, dan scale yang sesuai untuk baris panjang. Proses ini merender source; proses ini tidak melakukan assembly atau validasi.

Mengonversi Solid Edge atau assembly CAD lainnya

1. Buka assembly dalam aplikasi CAD native-nya dan selesaikan reference part, subassembly, material, dan texture yang hilang sebelum melakukan export.
2. Gunakan command Publish 3D PDF dari Solid Edge, jika tersedia pada release dan license yang terpasang, lalu pilih view, model properties, PMI, dan assembly structure yang diperlukan. Nama command dan ketersediaan 3D-PDF berbeda-beda menurut release.
3. Untuk dokumen technical yang datar, buat atau buka drawing lalu gunakan File → Export atau Print untuk membuat PDF 2D. Proses ini menghasilkan drawing sheet, bukan model 3D interaktif.
4. Buka hasilnya dalam desktop PDF viewer yang mendukung embedded 3D content. Banyak browser PDF viewer dan mobile app hanya menampilkan halaman atau menghilangkan fitur 3D interaktif.

Sistem CAD lain mungkin dapat mem-publish 3D PDF secara langsung atau memerlukan exporter atau translator. Generic online converter bukan pengganti yang andal karena mungkin mengabaikan assembly reference, menekan component, atau hanya mendukung drawing 2D.

Online converter

CloudConvert dan Online-Convert dapat berguna untuk pekerjaan plain-text-to-PDF ketika service tersebut secara eksplisit menerima file yang di-upload atau menerima salinan .txt sementara. Verifikasi input type, encoding, page layout, dan text yang dihasilkan sebelum membagikan hasilnya. Online service biasanya tidak mendukung Solid Edge assembly atau interactive 3D PDF export.

Jangan meng-upload firmware proprietary, credential, exploit research, source yang belum dirilis, atau data CAD rahasia kecuali ketentuan retention dan processing service tersebut dapat diterima. Export melalui editor, browser, atau native-CAD secara lokal menghindari paparan tersebut.

Batasan kualitas dan kompatibilitas

Konversi PDF tidak menyelesaikan include file, memperluas macro, mendeteksi assembler error, mempertahankan build setting, atau mereproduksi executable output suatu program. Buka source menggunakan encoding sebenarnya, biasanya UTF-8, sebelum mencetak; encoding yang salah dapat mengganti comment non-ASCII. Periksa baris panjang, tab, line number, page break, symbol, dan syntax color dalam PDF final.

Simpan file .asm asli beserta project terkait atau file component CAD-nya. PDF text extraction dapat mengubah tab, whitespace, line ending, dan reading order, sementara 3D PDF mungkin menghilangkan fitur CAD yang tidak didukung. Untuk salinan arsip, catat processor, assembler dan version, source encoding, aplikasi CAD dan version jika berlaku, export setting, serta tanggal konversi.