Initial commit

2026-02-22 02:25:43 +00:00 · 2026-02-01 15:07:11 +01:00
commit 92e8af31c3
9 changed files with 548 additions and 0 deletions
--- a/demo/content/posts/asm.md
+++ b/demo/content/posts/asm.md
@@ -0,0 +1,154 @@
+---
+title: "Adding ASM code blocks"
+date: 2026-02-01
+summary: "How to add assembly code blocks in Hugo using custom shortcodes"
+aliases: ["/posts/asm/"]
+tags: ["hugo", "asm", "assembly", "code blocks"]
+author: "Noham"
+showToc: true
+TocOpen: false
+draft: true
+hidemeta: false
+comments: true
+disableHLJS: false
+disableShare: false
+hideSummary: false
+searchHidden: true
+ShowReadingTime: true
+ShowBreadCrumbs: true
+ShowPostNavLinks: true
+ShowWordCount: true
+ShowRssButtonInSectionTermList: true
+UseHugoToc: true
+---
+
+### x86 basic example
+```go-html-template
+{{</* asm mode="raw" arch="x86" */>}}
+mov rax, 1
+xor rdi, rdi
+syscall
+{{</* /asm */>}}
+```
+
+{{< asm mode="raw" arch="x86" >}}
+mov rax, 1
+xor rdi, rdi
+syscall
+{{< /asm >}}
+
+### ARM64 basic example
+```go-html-template
+{{</* asm mode="raw" arch="arm" */>}}
+mov w0, #1
+mov w1, #1
+add w2, w0, w1
+ret
+{{</* /asm */>}}
+```
+
+{{< asm mode="raw" arch="arm" >}}
+mov w0, #1
+mov w1, #1
+add w2, w0, w1
+ret
+{{< /asm >}}
+
+
+### x86 + hex example
+```go-html-template
+{{</* asm mode="hex" arch="x86" */>}}
+48 c7 c0 01 00 00 00 | mov rax, 1
+48 31 ff             | xor rdi, rdi
+0f 05                | syscall
+{{</* /asm */>}}
+```
+
+{{< asm mode="hex" arch="x86" >}}
+48 c7 c0 01 00 00 00 | mov rax, 1
+48 31 ff             | xor rdi, rdi
+0f 05                | syscall
+{{< /asm >}}
+
+### Hex with capitalization
+```go-html-template
+{{</* asm mode="hex" capitalize="true" */>}}
+48 c7 c0 01 00 00 00 | mov rax, 1
+{{</* /asm */>}}
+```
+
+{{< asm mode="hex" capitalize="true" >}}
+48 c7 c0 01 00 00 00 | mov rax, 1
+{{< /asm >}}
+
+### Full example
+```go-html-template
+{{</* asm mode="full" arch="arm" */>}}
+00000000 | 20 00 80 52 | mov w0, #1
+00000004 | 21 00 80 52 | mov w1, #1
+00000008 | c0 03 5f d6 | ret
+{{</* /asm */>}}
+```
+
+{{< asm mode="full" arch="arm" >}}
+00000000 | 20 00 80 52 | mov w0, #1
+00000004 | 21 00 80 52 | mov w1, #1
+00000008 | c0 03 5f d6 | ret
+{{< /asm >}}
+
+### Full with capitalization
+```go-html-template
+{{</* asm mode="full" arch="x86" capitalize="true" */>}}
+00401000 | 48 c7 c0 01 00 00 00 | mov rax, 1
+00401007 | 48 31 ff             | xor rdi, rdi
+0040100a | 0f 05                | syscall
+{{</* /asm */>}}
+```
+
+{{< asm mode="full" arch="x86" capitalize="true" >}}
+00401000 | 48 c7 c0 01 00 00 00 | mov rax, 1
+00401007 | 48 31 ff             | xor rdi, rdi
+0040100a | 0f 05                | syscall
+{{< /asm >}}
+
+### ARM64 with hex bytes
+```go-html-template
+{{</* asm mode="hex" arch="arm" */>}}
+20 00 80 52 | mov w0, #1
+21 00 80 52 | mov w1, #1
+42 00 01 0b | add w2, w2, w1
+c0 03 5f d6 | ret
+{{</* /asm */>}}
+```
+
+{{< asm mode="hex" arch="arm" >}}
+20 00 80 52 | mov w0, #1
+21 00 80 52 | mov w1, #1
+42 00 01 0b | add w2, w2, w1
+c0 03 5f d6 | ret
+{{< /asm >}}
+
+### Longer x86 function example
+```go-html-template
+{{</* asm mode="full" arch="x86" */>}}
+00401000 | 55                   | push rbp
+00401001 | 48 89 e5             | mov rbp, rsp
+00401004 | 48 83 ec 10          | sub rsp, 0x10
+00401008 | 89 7d fc             | mov [rbp-0x4], edi
+0040100b | 8b 45 fc             | mov eax, [rbp-0x4]
+0040100e | 83 c0 01             | add eax, 0x1
+00401011 | c9                   | leave
+00401012 | c3                   | ret
+{{</* /asm */>}}
+```
+
+{{< asm mode="full" arch="x86" >}}
+00401000 | 55                   | push rbp
+00401001 | 48 89 e5             | mov rbp, rsp
+00401004 | 48 83 ec 10          | sub rsp, 0x10
+00401008 | 89 7d fc             | mov [rbp-0x4], edi
+0040100b | 8b 45 fc             | mov eax, [rbp-0x4]
+0040100e | 83 c0 01             | add eax, 0x1
+00401011 | c9                   | leave
+00401012 | c3                   | ret
+{{< /asm >}}