|
@@ -88,45 +88,6 @@ https://gogs.elic.ucl.ac.be/pbarriat/learning-vscode
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
-### VS Code in WSL
|
|
|
|
-
|
|
|
|
-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
|
|
|
|
-```
|
|
|
|
-
|
|
|
|
----
|
|
|
|
-
|
|
|
|
-### 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 Markdown`
|
|
|
|
-
|
|
|
|
----
|
|
|
|
-
|
|
|
|
## Pandoc
|
|
## Pandoc
|
|
|
|
|
|
Pandoc is a library for converting from one markup format to another, and a command-line tool that uses this library.
|
|
Pandoc is a library for converting from one markup format to another, and a command-line tool that uses this library.
|
|
@@ -174,28 +135,49 @@ Marp (MarkDown slides extension) can convert **Marp Markdown** files into static
|
|
|
|
|
|
Download and install marp-cli (a **CLI** interface for Marp) from the standalone binaries
|
|
Download and install marp-cli (a **CLI** interface for Marp) from the standalone binaries
|
|
> free and [available](https://github.com/marp-team/marp-cli/releases/) for macOS, Windows and Linux
|
|
> free and [available](https://github.com/marp-team/marp-cli/releases/) for macOS, Windows and Linux
|
|
-> you must install Chrome, Chromium or Edge
|
|
|
|
|
|
|
|
```bash
|
|
```bash
|
|
-cd
|
|
|
|
-wget https://github.com/marp-team/marp-cli/releases/download/v2.5.0/marp-cli-v2.5.0-linux.tar.gz
|
|
|
|
|
|
+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
|
|
tar xzf marp-cli-v2.5.0-linux.tar.gz
|
|
mv marp bin ; rm -f marp-cli-v2.5.0-linux.tar.gz
|
|
mv marp bin ; rm -f marp-cli-v2.5.0-linux.tar.gz
|
|
```
|
|
```
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
+### You must install Chrome, Chromium or Edge
|
|
|
|
+
|
|
|
|
+*True* Ubuntu, install **chromium-browser**
|
|
|
|
+
|
|
|
|
+```bash
|
|
|
|
+sudo apt install chromium-browser -y
|
|
|
|
+```
|
|
|
|
+
|
|
|
|
+Ubuntu with WSL, add *ppa* for **google-chrome** and install it
|
|
|
|
+
|
|
|
|
+```bash
|
|
|
|
+wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmour -o /usr/share/keyrings/google_linux_signing_key.gpg
|
|
|
|
+sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google_linux_signing_key.gpg] http://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google.list'
|
|
|
|
+sudo apt update
|
|
|
|
+sudo apt install google-chrome-stable
|
|
|
|
+```
|
|
|
|
+
|
|
|
|
+> In WSL, snapd is not available by default and chromium-browser needs it
|
|
|
|
+
|
|
|
|
+---
|
|
|
|
+
|
|
## VS Code nice extensions
|
|
## 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`
|
|
|
|
|
|
+Open VS Code and install the following extensions
|
|
|
|
+
|
|
|
|
+- `Markdown All in One` : *v3.5.1 - Yu Zhang*
|
|
|
|
+- `Marp for VS Code` : *v2.6.0 - Marp team*
|
|
|
|
|
|
-And :
|
|
|
|
|
|
+And maybe :
|
|
|
|
|
|
-- `Modern Fortran`
|
|
|
|
|
|
+- `Markdown Preview Enhanced` : *v0.6.8 - Yiyi Wang*
|
|
|
|
+- `Markdownlint` : *v0.50.0 - David Anson*
|
|
|
|
+- `Pandoc Markdown` : *v0.1.2 - rsolano*
|
|
|
|
+- `Excel to Markdown table` : *v1.3.0 - Sebastian Holmqvist*
|
|
|
|
|
|
---
|
|
---
|
|
|
|
|
|
@@ -321,7 +303,7 @@ Here, we use a `yaml` file to write all the pandoc options (passed with `-d`)
|
|
## Scientific manuscript
|
|
## Scientific manuscript
|
|
|
|
|
|
```bash
|
|
```bash
|
|
-pandoc -d article_nice.yaml
|
|
|
|
|
|
+pandoc -d nice_article.yaml
|
|
```
|
|
```
|
|
|
|
|
|
---
|
|
---
|