diff --git a/markdown/Makefile b/markdown/Makefile new file mode 100644 index 0000000..4a1b2c2 --- /dev/null +++ b/markdown/Makefile @@ -0,0 +1,22 @@ +SRC = ./slides/*.md +TEMP_DIR = ./work/ +TEMP_MD = $(TEMP_DIR)/work.md +OUT_DIR = ./out/ +INCLUDE_DIR = ./media/ + +all: $(OUT_DIR)/index.html + +$(OUT_DIR)/index.html: $(TEMP_MD) + mkdir -p $(OUT_DIR) + mdslides $(TEMP_MD) --include $(INCLUDE_DIR) --output $(OUT_DIR) + +$(TEMP_MD): $(SRC) + mkdir -p $(TEMP_DIR) + cat $(SRC) > $(TEMP_MD) + +preview: $(OUT_DIR)/index.html + xdg-open $(OUT_DIR)/index.html + +clean: + rm -rf $(OUT_DIR)/ + rm -rf $(TEMP_DIR)/ diff --git a/markdown/README.md b/markdown/README.md new file mode 100644 index 0000000..be931be --- /dev/null +++ b/markdown/README.md @@ -0,0 +1,17 @@ +# Linux Graphics Stack + + + +### Building + +Requirements: +- [markdown-slides](https://gitlab.com/da_doomer/markdown-slides) +- GNU Make +- A JS capable web browser + +0. Clone this repository +1. `make clean` +2. `make` +3. `make preview` or open `./out/index.html` in a JS capable web browser + +For instructions on presenting, refer to RevealJS documentation. diff --git a/markdown/media/Cc-by-nc-sa_icon.svg b/markdown/media/Cc-by-nc-sa_icon.svg new file mode 100644 index 0000000..7dc79d4 --- /dev/null +++ b/markdown/media/Cc-by-nc-sa_icon.svg @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/markdown/media/example-docs.webp b/markdown/media/example-docs.webp new file mode 100644 index 0000000..65c7533 Binary files /dev/null and b/markdown/media/example-docs.webp differ diff --git a/markdown/media/example-github.webp b/markdown/media/example-github.webp new file mode 100644 index 0000000..19885d3 Binary files /dev/null and b/markdown/media/example-github.webp differ diff --git a/markdown/media/example-image.webp b/markdown/media/example-image.webp new file mode 100644 index 0000000..5a9eb14 Binary files /dev/null and b/markdown/media/example-image.webp differ diff --git a/markdown/media/example-website.webp b/markdown/media/example-website.webp new file mode 100644 index 0000000..15bcc2d Binary files /dev/null and b/markdown/media/example-website.webp differ diff --git a/markdown/media/presentationsourceqr.svg b/markdown/media/presentationsourceqr.svg new file mode 100644 index 0000000..0b660d6 --- /dev/null +++ b/markdown/media/presentationsourceqr.svg @@ -0,0 +1,1258 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/markdown/slides/00-title.md b/markdown/slides/00-title.md new file mode 100644 index 0000000..13d0fa8 --- /dev/null +++ b/markdown/slides/00-title.md @@ -0,0 +1,15 @@ +[comment]: # (THEME = night) +[comment]: # (CODE_THEME = base16/zenburn) + +[comment]: # (controls: true) +[comment]: # (keyboard: true) +[comment]: # (markdown: { smartypants: true }) +[comment]: # (hash: true) +[comment]: # (respondToHashChanges: true) +[comment]: # (slideNumber: 'c/t') +[comment]: # (width: 1280) +[comment]: # (height: 720) + +# Markdown +By Logan G +[comment]: # (!!!) diff --git a/markdown/slides/01-markdown.md b/markdown/slides/01-markdown.md new file mode 100644 index 0000000..f3cdee7 --- /dev/null +++ b/markdown/slides/01-markdown.md @@ -0,0 +1,264 @@ +### Markdown + +- Created in 2004 +- Markup language + - Create formatted text from plaintext +- Easy to read and write +- Converts directly to HTML +- Originally designed for USENET and email +- Not very standardized + +Notes: +Ambuguity in the original Markdown spec + +[comment]: # (|||) + +
+
+ + +```markdown +# Header 1 + +## Header 2 + +###### Header 6 +``` + +
+
+ + +# Header 1 + +## Header 2 + +###### Header 6 + +
+ +[comment]: # (|||) + +
+
+ + +```markdown +*Italics text* + +**Bold text** + +***Bold and italics*** +*** +_Other italics text_ + +__Underlined__ + +___Underlined and italics___ +*** +[Example link](https://lug.mines.edu/attend) +``` + +
+
+ + +*Italics text* + +**Bold text** + +***Bold and italics*** +*** +_Other italics text_ + +__Underlined__ + +___Underlined and italics___ +*** +[Example link](https://lug.mines.edu/attend) + +
+ +[comment]: # (|||) + +
+
+ + +```markdown +Unordered/Bullet list: +- Thing 1 +- Thing 2 +- Thing 3 + +Ordered list: +1. Thing +2. Thing +3. Thing +``` + +
+
+ + +Unordered/Bullet list: +- Thing 1 +- Thing 2 +- Thing 3 + +Ordered list: +1. Thing +2. Thing +3. Thing + +
+ +[comment]: # (|||) + +
+
+ + + `printf("Hello world!\n");` + + *** + + ```c + #include "stdio.h" + + int main(void) { + printf("Hello world!\n"); + return 0; + } + ``` + +
+
+ + +`printf("Hello world!\n");` + +*** + +```c +#include "stdio.h" + +int main(void) { + printf("Hello world!\n"); + return 0; +} +``` + +
+ + +[comment]: # (|||) + +
+
+ + +```markdown +> Lorem ipsum dolor sit amet, +consectetuer adipiscing elit. +Aliquam hendrerit mi posuere lectus. +Vestibulum enim wisi, viverra nec, +fringilla in, laoreet vitae, risus. + +> Quote **with** Markdown + +> Nested quote +> > Lorem ipsum dolor sit amet, +consectetuer adipiscing elit. +Aliquam hendrerit mi posuere lectus. +Vestibulum enim wisi, viverra nec, +fringilla in, laoreet vitae, risus. +``` + +
+
+ + +
+ +> Lorem ipsum dolor sit amet, +consectetuer adipiscing elit. +Aliquam hendrerit mi posuere lectus. +Vestibulum enim wisi, viverra nec, +fringilla in, laoreet vitae, risus. + +> Quote **with** Markdown + +> Nested quote +> > Lorem ipsum dolor sit amet, +consectetuer adipiscing elit. +Aliquam hendrerit mi posuere lectus. +Vestibulum enim wisi, viverra nec, +fringilla in, laoreet vitae, risus. + +
+ +
+ +[comment]: # (|||) + +
+
+ + +```markdown +![Alt Text](media/example-image.webp) +``` + +
+
+ + + +![Alt Text](media/example-image.webp) + +
+ +[comment]: # (|||) + +
+
+ + +```markdown +This is **Markdown** formatted text! + +- Thing1 + +
+ +- Thing*2* + +
+ +- Thing3 +``` + +
+
+ + +This is **Markdown** formatted text! + +- Thing1 + +
+ +- Thing*2* + +
+ +- Thing3 + +
+ +[comment]: # (!!!) diff --git a/markdown/slides/02-commonmark.md b/markdown/slides/02-commonmark.md new file mode 100644 index 0000000..97132e8 --- /dev/null +++ b/markdown/slides/02-commonmark.md @@ -0,0 +1,7 @@ +### CommonMark + +- Created in 2014 +- Standardized version of Markdown +- Most Markdown variants are compatible with this + +[comment]: # (!!!) diff --git a/markdown/slides/03-gfm.md b/markdown/slides/03-gfm.md new file mode 100644 index 0000000..b527f27 --- /dev/null +++ b/markdown/slides/03-gfm.md @@ -0,0 +1,76 @@ +### GitHub Flavored Markdown + +- Created in 2009, standarized in 2017 +- 99% compatible with CommonMark + - Changes underscore parsing +- Adds useful extensions + - Tables + - Strikethrough + - Autolinks + - Tasklists +- Most modern Markdown parsers implement this + +[comment]: # (|||) + +
+
+ + +
+ +```markdown +| Left | Center | Right | +|------------|:---------------:|-------------:| +| You can do | **Markdown** in | these cells! | +``` + +
+
+
+ + +
+ +| Left | Center | Right | +|------------|:---------------:|-------------:| +| You can do | **Markdown** in | these cells! | + +
+
+ +[comment]: # (|||) + +
+
+ + +```markdown +~~Strikethrough~~ + +https://lug.mines.edu/attend + +- [ ] Homework +- [x] Drank 53 energy drinks +- [x] Ate 2 cans of beans + +Example of some_thing_ that doesn't parse +in GFM +``` + +
+
+ + +~~Strikethrough~~ + +https://lug.mines.edu/attend + +- [ ] Homework +- [x] Drank 53 energy drinks +- [x] Ate 2 cans of beans + +Example of some_thing_ that doesn't parse +in GFM +
+ +[comment]: # (!!!) diff --git a/markdown/slides/04-goodfor.md b/markdown/slides/04-goodfor.md new file mode 100644 index 0000000..0d62c1a --- /dev/null +++ b/markdown/slides/04-goodfor.md @@ -0,0 +1,47 @@ +### What is Markdown actually useful for? + +[comment]: # (|||) + +![Example of GitHub README](media/example-github.webp) + +
+ +Example of GitHub README.md + +
+ +[comment]: # (|||) + +![Example of Hugo website](media/example-website.webp) + +
+ +Screenshot of https://kubernetes.io by the Cloud Native Computing Foundation + +Taken on 2025-03-12 at 23:39 UTC + +Licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.en) + +
+ +[comment]: # (|||) + +![Example of documentation](media/example-docs.webp) + +
+ +Screenshot of The Rust Programming Language Book by The Rust Foundation + +Taken on 2025-03-12 at 23:46 UTC + +Licensed under [Apache 2.0](https://github.com/rust-lang/book/blob/main/LICENSE-APACHE)/[MIT](https://github.com/rust-lang/book/blob/main/LICENSE-MIT) + +
+ +[comment]: # (|||) + + + +[comment]: # (!!!) diff --git a/markdown/slides/98-source.md b/markdown/slides/98-source.md new file mode 100644 index 0000000..df598a8 --- /dev/null +++ b/markdown/slides/98-source.md @@ -0,0 +1,10 @@ +![Presentation Source QR](media/presentationsourceqr.svg) + +[Presentation Source](https://git.qtechofficial.com/logan/presentations/src/branch/master/linuxgraphicsstack) + +
+ +This presentation is licensed under [CC-BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.en) + +![CC-BY-NC-SA Icon](media/Cc-by-nc-sa_icon.svg) +[comment]: # (!!!) diff --git a/markdown/slides/99-funfacts.md b/markdown/slides/99-funfacts.md new file mode 100644 index 0000000..bcc6f82 --- /dev/null +++ b/markdown/slides/99-funfacts.md @@ -0,0 +1,8 @@ +## Fun Facts: + +This presentation took 0 hours + +
+ +Made with [markdown-slides](https://gitlab.com/da_doomer/markdown-slides) + reveal.js +[comment]: # (!!!)