Commit 31fe13dc authored by Arnaud Legrand's avatar Arnaud Legrand

Starting an introduction to Markdown

parent 6954e259
all: introduction_to_markdown.html
%.html: %.org
emacs -batch $^ --funcall org-html-export-to-html
sed -i 's/<pre /<pre style="padding-left: 30px; background-color: #f6f8fa;" /g' $@
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2018-07-19 jeu. 15:43 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Introduction à Markdown</title>
<meta name="generator" content="Org mode" />
<meta name="author" content="Arnaud Legrand" />
<style type="text/css">
<!--/*--><![CDATA[/*><!--*/
.title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
.todo { font-family: monospace; color: red; }
.done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #ccc;
box-shadow: 3px 3px 3px #eee;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: visible;
padding-top: 1.2em;
}
pre.src:before {
display: none;
position: absolute;
background-color: white;
top: -10px;
right: 10px;
padding: 3px;
border: 1px solid black;
}
pre.src:hover:before { display: inline;}
/* Languages per Org manual */
pre.src-asymptote:before { content: 'Asymptote'; }
pre.src-awk:before { content: 'Awk'; }
pre.src-C:before { content: 'C'; }
/* pre.src-C++ doesn't work in CSS */
pre.src-clojure:before { content: 'Clojure'; }
pre.src-css:before { content: 'CSS'; }
pre.src-D:before { content: 'D'; }
pre.src-ditaa:before { content: 'ditaa'; }
pre.src-dot:before { content: 'Graphviz'; }
pre.src-calc:before { content: 'Emacs Calc'; }
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
pre.src-fortran:before { content: 'Fortran'; }
pre.src-gnuplot:before { content: 'gnuplot'; }
pre.src-haskell:before { content: 'Haskell'; }
pre.src-hledger:before { content: 'hledger'; }
pre.src-java:before { content: 'Java'; }
pre.src-js:before { content: 'Javascript'; }
pre.src-latex:before { content: 'LaTeX'; }
pre.src-ledger:before { content: 'Ledger'; }
pre.src-lisp:before { content: 'Lisp'; }
pre.src-lilypond:before { content: 'Lilypond'; }
pre.src-lua:before { content: 'Lua'; }
pre.src-matlab:before { content: 'MATLAB'; }
pre.src-mscgen:before { content: 'Mscgen'; }
pre.src-ocaml:before { content: 'Objective Caml'; }
pre.src-octave:before { content: 'Octave'; }
pre.src-org:before { content: 'Org mode'; }
pre.src-oz:before { content: 'OZ'; }
pre.src-plantuml:before { content: 'Plantuml'; }
pre.src-processing:before { content: 'Processing.js'; }
pre.src-python:before { content: 'Python'; }
pre.src-R:before { content: 'R'; }
pre.src-ruby:before { content: 'Ruby'; }
pre.src-sass:before { content: 'Sass'; }
pre.src-scheme:before { content: 'Scheme'; }
pre.src-screen:before { content: 'Gnu Screen'; }
pre.src-sed:before { content: 'Sed'; }
pre.src-sh:before { content: 'shell'; }
pre.src-sql:before { content: 'SQL'; }
pre.src-sqlite:before { content: 'SQLite'; }
/* additional languages in org.el's org-babel-load-languages alist */
pre.src-forth:before { content: 'Forth'; }
pre.src-io:before { content: 'IO'; }
pre.src-J:before { content: 'J'; }
pre.src-makefile:before { content: 'Makefile'; }
pre.src-maxima:before { content: 'Maxima'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-picolisp:before { content: 'Pico Lisp'; }
pre.src-scala:before { content: 'Scala'; }
pre.src-shell:before { content: 'Shell Script'; }
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
/* additional language identifiers per "defun org-babel-execute"
in ob-*.el */
pre.src-cpp:before { content: 'C++'; }
pre.src-abc:before { content: 'ABC'; }
pre.src-coq:before { content: 'Coq'; }
pre.src-groovy:before { content: 'Groovy'; }
/* additional language identifiers from org-babel-shell-names in
ob-shell.el: ob-shell is the only babel language using a lambda to put
the execution function name together. */
pre.src-bash:before { content: 'bash'; }
pre.src-csh:before { content: 'csh'; }
pre.src-ash:before { content: 'ash'; }
pre.src-dash:before { content: 'dash'; }
pre.src-ksh:before { content: 'ksh'; }
pre.src-mksh:before { content: 'mksh'; }
pre.src-posh:before { content: 'posh'; }
/* Additional Emacs modes also supported by the LaTeX listings package */
pre.src-ada:before { content: 'Ada'; }
pre.src-asm:before { content: 'Assembler'; }
pre.src-caml:before { content: 'Caml'; }
pre.src-delphi:before { content: 'Delphi'; }
pre.src-html:before { content: 'HTML'; }
pre.src-idl:before { content: 'IDL'; }
pre.src-mercury:before { content: 'Mercury'; }
pre.src-metapost:before { content: 'MetaPost'; }
pre.src-modula-2:before { content: 'Modula-2'; }
pre.src-pascal:before { content: 'Pascal'; }
pre.src-ps:before { content: 'PostScript'; }
pre.src-prolog:before { content: 'Prolog'; }
pre.src-simula:before { content: 'Simula'; }
pre.src-tcl:before { content: 'tcl'; }
pre.src-tex:before { content: 'TeX'; }
pre.src-plain-tex:before { content: 'Plain TeX'; }
pre.src-verilog:before { content: 'Verilog'; }
pre.src-vhdl:before { content: 'VHDL'; }
pre.src-xml:before { content: 'XML'; }
pre.src-nxml:before { content: 'XML'; }
/* add a generic configuration mode; LaTeX export needs an additional
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
pre.src-conf:before { content: 'Configuration File'; }
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
th.org-right { text-align: center; }
th.org-left { text-align: center; }
th.org-center { text-align: center; }
td.org-right { text-align: right; }
td.org-left { text-align: left; }
td.org-center { text-align: center; }
dt { font-weight: bold; }
.footpara { display: inline; }
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
.org-svg { width: 90%; }
/*]]>*/-->
</style>
<script type="text/javascript">
/*
@licstart The following is the entire license notice for the
JavaScript code in this tag.
Copyright (C) 2012-2018 Free Software Foundation, Inc.
The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License (GNU GPL) as published by the Free Software
Foundation, either version 3 of the License, or (at your option)
any later version. The code is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
As additional permission under GNU GPL version 3 section 7, you
may distribute non-source (e.g., minimized or compacted) forms of
that code without the copy of the GNU GPL normally required by
section 4, provided you include this license notice and a URL
through which recipients can access the Corresponding Source.
@licend The above is the entire license notice
for the JavaScript code in this tag.
*/
<!--/*--><![CDATA[/*><!--*/
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
</script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
displayAlign: "center",
displayIndent: "0em",
"HTML-CSS": { scale: 100,
linebreaks: { automatic: "false" },
webFont: "TeX"
},
SVG: {scale: 100,
linebreaks: { automatic: "false" },
font: "TeX"},
NativeMML: {scale: 100},
TeX: { equationNumbers: {autoNumber: "AMS"},
MultLineWidth: "85%",
TagSide: "right",
TagIndent: ".8em"
}
});
</script>
<script type="text/javascript"
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS_HTML"></script>
</head>
<body>
<div id="content">
<h1 class="title">Introduction à Markdown</h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#orga90a211">Syntaxe</a>
<ul>
<li><a href="#org1945f46">Headers</a></li>
<li><a href="#org4bde3dc">Emphasis</a></li>
<li><a href="#orge64bd2d">Lists</a>
<ul>
<li><a href="#org282becb">Unordered</a></li>
<li><a href="#orgee9c979">Ordered</a></li>
</ul>
</li>
<li><a href="#org3c383dc">Images</a></li>
<li><a href="#org25a5db5">Links</a></li>
<li><a href="#org8f216b7">Blockquotes</a></li>
<li><a href="#org27c03d1">Inline code</a></li>
</ul>
</li>
<li><a href="#org85a39f0">Écrire des Maths</a>
<ul>
<li><a href="#org67d696e">Lettres grecques</a></li>
<li><a href="#orgad46324">Operators</a></li>
</ul>
</li>
</ul>
</div>
</div>
<p>
Voici un aperçu rapide de la syntaxe Markdown repris d'une
<a href="https://guides.github.com/features/mastering-markdown/">présentation de Github</a> ainsi que de celles d'<a href="http://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/">Archer Reilly</a> et de <a href="http://www.statpower.net/Content/310/R%20Stuff/SampleMarkdown.html">James
H. Steiger</a>.
</p>
<div id="outline-container-orga90a211" class="outline-2">
<h2 id="orga90a211">Syntaxe</h2>
<div class="outline-text-2" id="text-orga90a211">
</div>
<div id="outline-container-org1945f46" class="outline-3">
<h3 id="org1945f46">Headers</h3>
<div class="outline-text-3" id="text-org1945f46">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
# This is an &lt;h1&gt; tag
## This is an &lt;h2&gt; tag
###### This is an &lt;h6&gt; tag
</pre>
</div>
</div>
<div id="outline-container-org4bde3dc" class="outline-3">
<h3 id="org4bde3dc">Emphasis</h3>
<div class="outline-text-3" id="text-org4bde3dc">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
*This text will be italic*
_This will also be italic_
**This text will be bold**
__This will also be bold__
_You **can** combine them_
</pre>
</div>
</div>
<div id="outline-container-orge64bd2d" class="outline-3">
<h3 id="orge64bd2d">Lists</h3>
<div class="outline-text-3" id="text-orge64bd2d">
</div>
<div id="outline-container-org282becb" class="outline-4">
<h4 id="org282becb">Unordered</h4>
<div class="outline-text-4" id="text-org282becb">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
* Item 1
* Item 2
* Item 2a
* Item 2b
</pre>
</div>
</div>
<div id="outline-container-orgee9c979" class="outline-4">
<h4 id="orgee9c979">Ordered</h4>
<div class="outline-text-4" id="text-orgee9c979">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
1. Item 1
1. Item 2
1. Item 3
1. Item 3a
1. Item 3b
</pre>
</div>
</div>
</div>
<div id="outline-container-org3c383dc" class="outline-3">
<h3 id="org3c383dc">Images</h3>
<div class="outline-text-3" id="text-org3c383dc">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)
</pre>
</div>
</div>
<div id="outline-container-org25a5db5" class="outline-3">
<h3 id="org25a5db5">Links</h3>
<div class="outline-text-3" id="text-org25a5db5">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
http://github.com - automatic!
[GitHub](http://github.com)
</pre>
</div>
</div>
<div id="outline-container-org8f216b7" class="outline-3">
<h3 id="org8f216b7">Blockquotes</h3>
<div class="outline-text-3" id="text-org8f216b7">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
As Kanye West said:
&gt; We're living the future so
&gt; the present is our past.
</pre>
</div>
</div>
<div id="outline-container-org27c03d1" class="outline-3">
<h3 id="org27c03d1">Inline code</h3>
<div class="outline-text-3" id="text-org27c03d1">
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
I think you should use an
`&lt;addr&gt;` element here instead.
</pre>
</div>
</div>
</div>
<div id="outline-container-org85a39f0" class="outline-2">
<h2 id="org85a39f0">Écrire des Maths</h2>
<div class="outline-text-2" id="text-org85a39f0">
<p>
Equations can be formatted <b>inline</b> or as <b>displayed formulas</b>. In the
latter case, they are centered and set off from the main text. In the
former case, the mathematical material occurs smoothly in the line of
text.
</p>
<p>
In order to fit neatly in a line, summation expressions (and similar
constructs) are formatted slightly differently in their inline and
display versions.
</p>
<p>
Inline mathematical material is set off by the use of single
dollar-sign characters. Consequently, if you wish to use a dollar sign
(for example, to indicate currency), you need to preface it with a
back-slash. The following examples, followed by their typeset
versions, should make this clear
</p>
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
This summation expression $\sum_{i=1}^n X_i$ appears inline.
</pre>
<p>
This summation expression \(\sum_{i=1}^n X_i\) appears inline.
</p>
<pre style="padding-left: 30px; background-color: #f6f8fa;" class="example">
This summation expression is in display form.
$$\sum_{i=1}^n X_i$$
</pre>
<p>
This summation expression is in display form.
</p>
<p>
\[\sum_{i=1}^n X_i\]
</p>
</div>
<div id="outline-container-org67d696e" class="outline-3">
<h3 id="org67d696e">Lettres grecques</h3>
<div class="outline-text-3" id="text-org67d696e">
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
<colgroup>
<col class="org-left" />
<col class="org-left" />
</colgroup>
<thead>
<tr>
<th scope="col" class="org-left">Symbole</th>
<th scope="col" class="org-left">Commande</th>
</tr>
</thead>
<tbody>
<tr>
<td class="org-left">\(\alpha\)</td>
<td class="org-left"><code>$\alpha=</code></td>
</tr>
<tr>
<td class="org-left">\(\beta\)</td>
<td class="org-left"><code>$\beta$</code></td>
</tr>
<tr>
<td class="org-left">\(\gamma\)</td>
<td class="org-left"><code>$\gamma$</code></td>
</tr>
<tr>
<td class="org-left">\(\Gamma\)</td>
<td class="org-left"><code>$\Gamma$</code></td>
</tr>
<tr>
<td class="org-left">\(\pi\)</td>
<td class="org-left"><code>$\pi$</code></td>
</tr>
</tbody>
</table>
</div>
</div>
<div id="outline-container-orgad46324" class="outline-3">
<h3 id="orgad46324">Operators</h3>
</div>
</div>
</div>
<div id="postamble" class="status">
<p class="date">Date: June, 2018</p>
<p class="author">Author: Arnaud Legrand</p>
<p class="date">Created: 2018-07-19 jeu. 15:43</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>
</html>
# -*- mode: org -*-
#+TITLE: Introduction à Markdown
#+AUTHOR: Arnaud Legrand
#+DATE: June, 2018
#+LANG: fr
#+STARTUP: overview indent
#+OPTIONS: num:nil toc:t
Voici un aperçu rapide de la syntaxe Markdown repris d'une
[[https://guides.github.com/features/mastering-markdown/][présentation de Github]] ainsi que de celles d'[[http://csrgxtu.github.io/2015/03/20/Writing-Mathematic-Fomulars-in-Markdown/][Archer Reilly]] et de [[http://www.statpower.net/Content/310/R%2520Stuff/SampleMarkdown.html][James
H. Steiger]].
* Syntaxe
** Headers
#+BEGIN_EXAMPLE
# This is an <h1> tag
## This is an <h2> tag
###### This is an <h6> tag
#+END_EXAMPLE
** Emphasis
#+BEGIN_EXAMPLE
*This text will be italic*
_This will also be italic_
**This text will be bold**
__This will also be bold__
_You **can** combine them_
#+END_EXAMPLE
** Lists
*** Unordered
#+BEGIN_EXAMPLE
* Item 1
* Item 2
* Item 2a
* Item 2b
#+END_EXAMPLE
*** Ordered
#+BEGIN_EXAMPLE
1. Item 1
1. Item 2
1. Item 3
1. Item 3a
1. Item 3b
#+END_EXAMPLE
** Images
#+BEGIN_EXAMPLE
![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)
#+END_EXAMPLE
** Links
#+BEGIN_EXAMPLE
http://github.com - automatic!
[GitHub](http://github.com)
#+END_EXAMPLE
** Blockquotes
#+BEGIN_EXAMPLE
As Kanye West said:
> We're living the future so
> the present is our past.
#+END_EXAMPLE
** Inline code
#+BEGIN_EXAMPLE
I think you should use an
`<addr>` element here instead.
#+END_EXAMPLE
* Écrire des Maths
Equations can be formatted *inline* or as *displayed formulas*. In the
latter case, they are centered and set off from the main text. In the
former case, the mathematical material occurs smoothly in the line of
text.
In order to fit neatly in a line, summation expressions (and similar
constructs) are formatted slightly differently in their inline and
display versions.
Inline mathematical material is set off by the use of single
dollar-sign characters. Consequently, if you wish to use a dollar sign
(for example, to indicate currency), you need to preface it with a
back-slash. The following examples, followed by their typeset
versions, should make this clear
#+BEGIN_EXAMPLE
This summation expression $\sum_{i=1}^n X_i$ appears inline.
#+END_EXAMPLE
This summation expression $\sum_{i=1}^n X_i$ appears inline.
#+BEGIN_EXAMPLE
This summation expression is in display form.
$$\sum_{i=1}^n X_i$$
#+END_EXAMPLE
This summation expression is in display form.
$$\sum_{i=1}^n X_i$$
** Lettres grecques
| Symbole | Commande |
|---------+----------|
| $\alpha$ | =$\alpha== |
| $\beta$ | =$\beta$= |
| $\gamma$ | =$\gamma$= |
| $\Gamma$ | =$\Gamma$= |
| $\pi$ | =$\pi$= |
** Operators
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment