|
@@ -15,7 +15,7 @@ math: true
|
|
|
Markdown and applications<!--fit-->
|
|
|
===
|
|
|
|
|
|
-https://gogs.elic.ucl.ac.be/pbarriat/learning-linux
|
|
|
+https://gogs.elic.ucl.ac.be/pbarriat/learning-markdown
|
|
|
|
|
|

|
|
|
|
|
@@ -79,35 +79,51 @@ After you've become familiar with Markdown, you may want to use a Markdown appli
|
|
|
## Visual Studio Code
|
|
|
|
|
|
VSC is one of the most popular and powerful text editors used by software engineers today
|
|
|
-> free and available for [macOS](https://www.youtube.com/watch?v=8CJXB4Nu1wo), [Windows](https://www.youtube.com/watch?v=AdeWO-n9O2Q)
|
|
|
+> free and available for [macOS](https://www.youtube.com/watch?v=8CJXB4Nu1wo), [Windows](https://www.youtube.com/watch?v=AdeWO-n9O2Q) and [Linux](https://code.visualstudio.com/download)
|
|
|
|
|
|
-> Linux: `wget` the **deb** package then `dpkg -i code*.deb`
|
|
|
+### You didn't already install VS Code ?
|
|
|
|
|
|
-- Markdown All in One
|
|
|
-- Remote - SSH
|
|
|
-- Snippets
|
|
|
-- Tabnine
|
|
|
-- Regex Previewer
|
|
|
+Take a look here
|
|
|
+https://gogs.elic.ucl.ac.be/pbarriat/learning-vscode
|
|
|
|
|
|
---
|
|
|
|
|
|
-## VS Code in WSL
|
|
|
+### VS Code in WSL
|
|
|
|
|
|
-Open the Ubuntu terminal and do
|
|
|
+Open a **Powershell terminal** in **Administrator mode** and do
|
|
|
+
|
|
|
+```sh
|
|
|
+wsl --update
|
|
|
+```
|
|
|
+
|
|
|
+Open the **Ubuntu terminal** and do
|
|
|
|
|
|
```bash
|
|
|
sudo apt update
|
|
|
sudo apt upgrade
|
|
|
-
|
|
|
sudo apt install gedit -y
|
|
|
sudo apt install chromium-browser -y
|
|
|
-sudo apt install git -y
|
|
|
+```
|
|
|
|
|
|
-#wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
|
|
|
-#sudo dpkg -i google-chrome-stable_current_amd64.deb
|
|
|
+---
|
|
|
+
|
|
|
+### VS Code in Ubuntu
|
|
|
|
|
|
+Open the **terminal** and do
|
|
|
+
|
|
|
+```bash
|
|
|
+sudo apt update
|
|
|
+sudo apt upgrade
|
|
|
+sudo apt install chromium-browser -y
|
|
|
```
|
|
|
|
|
|
+### VS Code in any case
|
|
|
+
|
|
|
+Open VS Code and install the following extensions
|
|
|
+
|
|
|
+- `Markdown All in One`
|
|
|
+- `Marp`
|
|
|
+
|
|
|
---
|
|
|
|
|
|
## Pandoc
|
|
@@ -139,7 +155,7 @@ rm -rf pandoc-3.1.2 pandoc-3.1.2-linux-amd64.tar.gz pandoc-crossref-Linux.tar.xz
|
|
|
> free and available for [macOS](https://www.tug.org/mactex/), [Windows](https://miktex.org/download), and Linux
|
|
|
|
|
|
```bash
|
|
|
-sudo apt install texlive-latex-base \
|
|
|
+sudo apt install -y texlive-latex-base \
|
|
|
texlive-latex-recommended \
|
|
|
texlive-fonts-recommended \
|
|
|
texlive-latex-extra \
|
|
@@ -156,23 +172,48 @@ sudo apt install texlive-latex-base \
|
|
|
Marp (MarkDown slides extension) can convert **Marp Markdown** files into static HTML/CSS, PDF, PowerPoint document, and image(s) easily
|
|
|
|
|
|
Download and install marp-cli (a **CLI** interface for Marp) from the standalone binaries
|
|
|
-> free and available for [macOS](https://github.com/marp-team/marp-cli/releases/download/v2.4.0/marp-cli-v2.4.0-mac.tar.gz), [Windows](https://github.com/marp-team/marp-cli/releases/download/v2.4.0/marp-cli-v2.4.0-win.zip), and [Linux](https://github.com/marp-team/marp-cli/releases/download/v2.4.0/marp-cli-v2.4.0-linux.tar.gz)
|
|
|
-
|
|
|
+> free and [available](https://github.com/marp-team/marp-cli/releases/) for macOS, Windows and Linux
|
|
|
> you must install Chrome, Chromium or Edge
|
|
|
|
|
|
+```bash
|
|
|
+cd
|
|
|
+wget https://github.com/marp-team/marp-cli/releases/download/v2.5.0/marp-cli-v2.5.0-linux.tar.gz
|
|
|
+tar xzf marp-cli-v2.5.0-linux.tar.gz
|
|
|
+mv marp bin ; rm -f marp-cli-v2.5.0-linux.tar.gz
|
|
|
+```
|
|
|
+
|
|
|
---
|
|
|
|
|
|
-# Examples
|
|
|
+## VS Code nice extensions
|
|
|
+
|
|
|
+- `Remote - SSH` : lets you use any remote machine with a SSH server
|
|
|
+- `Tabnine` : code faster with AI code completions
|
|
|
+- `Regex Previewer` : shows the current regular expression's matches
|
|
|
+- `Markdown Preview Enhanced `
|
|
|
+- `Markdownlint`
|
|
|
+
|
|
|
+And :
|
|
|
|
|
|
-#marp --allow-local-files --theme tum.css git_elic.md -o git_elic.pdf
|
|
|
-#marp --template bespoke --bespoke.progress --allow-local-files --theme tum.css git_elic.md -o git_elic.html
|
|
|
+- `Modern Fortran`
|
|
|
|
|
|
-https://www.markdownguide.org/getting-started/
|
|
|
|
|
|
-https://jaantollander.com/post/scientific-writing-with-markdown/
|
|
|
+---
|
|
|
+
|
|
|
+# My first example: README.md
|
|
|
+
|
|
|
+---
|
|
|
|
|
|
-https://curvenote.com/blog/writing-a-scientific-paper-faster-myst-markdown
|
|
|
+# For my second example, I want slides
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# Now I want a small document: a letter
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# A bigger document ? a report maybe ?
|
|
|
+
|
|
|
+---
|
|
|
|
|
|
-https://github.com/MartinHeroux/pandoc_article_template
|
|
|
+# My last example: a scientific paper !
|
|
|
|
|
|
-https://phd.row1.ca/phd
|