Skip to content

Commit

Permalink
ci: rewrite me
Browse files Browse the repository at this point in the history
  • Loading branch information
shikaan committed Sep 7, 2024
1 parent e419903 commit 892277f
Show file tree
Hide file tree
Showing 5 changed files with 47 additions and 90 deletions.
50 changes: 0 additions & 50 deletions .github/workflows/jekyll.yml

This file was deleted.

4 changes: 1 addition & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,7 @@ sudo sh -c "wget -q https://shikaan.github.io/sup/install -O- | REPO=shikaan/shm
## Running an exercise

```sh
shmux build -- 00-file.asm

build/00-file.asm.out
shmux run -- 00-file.asm
```

## References
Expand Down
39 changes: 2 additions & 37 deletions docs/01-hello-world.md
Original file line number Diff line number Diff line change
@@ -1,41 +1,6 @@
An accessible assembly introduction for high-level programmers
Hello world
---

Coming from JavaScript, Rust, C, or any other high-level language, looking at assembly snippets can be confusing or even scary.

Let's take the following snippet:
```s
section .data
msg db "Hello, World!"
section .text
global _start
_start:
mov rax, 1
mov rdi, 1
mov rsi, msg
mov rdx, 13
syscall
mov rax, 60
mov rdi, 0
syscall
```
Thankfully the second line gives away what this does.

None of the bread and butter of programming as we know it is here: conditionals and loops are nowhere to be seen, there is no way to create functions... heck, variables don't even have names!

Where does one even start?

This little introduction is meant to introduce you, somebody with programming experience, to the world of assembly. We'll discuss the basics of the language and map them to high-level programming constructs.

By the end of this guide, you will be able to navigate assembly code, know where to look for information, and even write some simple programs all by yourself.

Let's get started!

# 1. Hello world

Unsurprisingly, our first program will be a "Hello World".

Before jumping into the code though, we need to briefly introduce the language and the utilities that will turn our code into running software. At the end of this section, we will be able to write, assemble, and run our first assembly program.
Expand Down Expand Up @@ -243,7 +208,7 @@ ld -o 01-hello-world.out 01-hello-world.o

## Conclusion

We have an hello world. Joy! 🛡️
We have an hello world. You're happy!

In this first article we learned some basic assembly concepts, we cut our teeth on its syntax, and we even wrote some working software.

Expand Down
8 changes: 8 additions & 0 deletions docs/_config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
title: A friendly introduction to assembly for high-level programmers
author: Manuel Spagnolo

remote_theme: huangyz0918/moving

theme_config:
back_home_text: "< Home"
date_format: "%Y-%m-%d"
36 changes: 36 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
Coming from JavaScript, Rust, C, or any other high-level language, looking at assembly snippets can be confusing or even scary.

Let's take the following snippet:
```asm
section .data
msg db "Hello, World!"
section .text
global _start
_start:
mov rax, 1
mov rdi, 1
mov rsi, msg
mov rdx, 13
syscall
mov rax, 60
mov rdi, 0
syscall
```
Thankfully the second line gives away what this does.

None of the bread and butter of programming as we know it is here: conditionals and loops are nowhere to be seen, there is no way to create functions... heck, variables don't even have names!

Where does one even start?

This little introduction is meant to introduce you, somebody with programming experience, to the world of assembly. We'll discuss the basics of the language and map them to high-level programming constructs.

By the end of this guide, you will be able to navigate assembly code, know where to look for information, and even write some simple programs all by yourself.

Let's get started!

## Content

* [01. Hello World](./01-hello-world)

0 comments on commit 892277f

Please sign in to comment.