la_vecchia_wiki_moinmoin/Markdown.html

67 lines
7.2 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Markdown</title>
<link rel="stylesheet" type="text/css" media="all" charset="utf-8" href="acaro/css/common.css">
<link rel="stylesheet" type="text/css" media="screen" charset="utf-8" href="acaro/css/screen.css">
<link rel="stylesheet" type="text/css" media="print" charset="utf-8" href="acaro/css/print.css">
<style type="text/css">
ul.pagetitle{
display: inline;
margin: 0;
padding: 0;
font-size: 1.5em;
}
li.pagetitle{
display: inline;
margin: 0;
}
td.noborder {
border: 0;
}
</style>
</head>
<body>
<table>
<tr>
<td class="noborder">
<img src="logo.png" width="85" height="85">
</td>
<td class="noborder">
<ul class="pagetitle">
<li class="pagetitle"><a class="backlink">Markdown</a>
</ul>
<br><br>
[<a href="FrontPage.html">FrontPage</a>]
</td>
</tr>
</table>
<hr>
<div id="page">
<div dir="ltr" id="content" lang="it"><span class="anchor" id="top"></span>
<span class="anchor" id="line-1-2"></span><span class="anchor" id="line-2-1"></span><span class="anchor" id="line-3-1"></span><span class="anchor" id="line-4-1"></span><p class="line867">
<h1 id="Markdown-1">Markdown</h1>
<span class="anchor" id="line-5-1"></span><span class="anchor" id="line-6-1"></span><p class="line867">
<h2 id="Pandoc">Pandoc</h2>
<span class="anchor" id="line-7-1"></span><p class="line867"><strong><a class="http" href="http://pandoc.org/" target="_blank">Pandoc</a></strong> è un convertitore di <span class="anchor" id="line-8-1"></span>documenti che supporta una moltitudine di formati. <span class="anchor" id="line-9-1"></span><span class="anchor" id="line-10"></span><p class="line874">Il trucco sta proprio nel convertire il documento in markdown (chiamato <span class="anchor" id="line-11"></span>sorgente) in un documento pdf (chiamato compilato o oggetto). Questo processo è <span class="anchor" id="line-12"></span>noto col nome di <em>compilazione</em>. <span class="anchor" id="line-13"></span><span class="anchor" id="line-14"></span><p class="line874">Quindi aprite il vostro editor preferito, create un nuovo file chiamato <span class="anchor" id="line-15"></span><tt class="backtick">esempio.md</tt> e scrivete: <span class="anchor" id="line-16"></span><span class="anchor" id="line-17"></span><p class="line867"><span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span><span class="anchor" id="line-20"></span><span class="anchor" id="line-21"></span><span class="anchor" id="line-22"></span><span class="anchor" id="line-23"></span><span class="anchor" id="line-24"></span><span class="anchor" id="line-25"></span><span class="anchor" id="line-26"></span><span class="anchor" id="line-27"></span><pre><span class="anchor" id="line-1"></span># Titolo
<span class="anchor" id="line-2"></span>
<span class="anchor" id="line-3"></span>## Sottotitolo
<span class="anchor" id="line-4"></span>
<span class="anchor" id="line-5"></span>Paragrafo
<span class="anchor" id="line-6"></span>
<span class="anchor" id="line-7"></span>1. uno
<span class="anchor" id="line-8"></span>2. due
<span class="anchor" id="line-9"></span>3. tre</pre><span class="anchor" id="line-28"></span><span class="anchor" id="line-29"></span><p class="line874">Ora aprite un terminare e spostatevi nella directory in cui avete salvato il file <span class="anchor" id="line-30"></span><tt class="backtick">esempio.md</tt>. Digitate: <span class="anchor" id="line-31"></span><span class="anchor" id="line-32"></span><p class="line867"><span class="anchor" id="line-33"></span><span class="anchor" id="line-34"></span><pre><span class="anchor" id="line-1-1"></span>pandoc esempio.md -o esempio.pdf</pre><span class="anchor" id="line-35"></span><span class="anchor" id="line-36"></span><p class="line862">Ora aprite il file <tt class="backtick">esempio.pdf</tt>: Enjoy <img alt=":)" height="16" src="/moin_static1911/acaro/img/smile.png" title=":)" width="16" /> <span class="anchor" id="line-37"></span><span class="anchor" id="line-38"></span><p class="line867">
<h2 id="Make">Make</h2>
<span class="anchor" id="line-39"></span><p class="line874">Data la flessibilità di tool come pandoc, ricordare e scrivere a mano ogni <span class="anchor" id="line-40"></span>comando diventa scomodo e potenzialmente dannoso. <span class="anchor" id="line-41"></span><span class="anchor" id="line-42"></span><p class="line862">Utility come <tt class="backtick">make</tt> risolvono esattamente questo tipo di problemi, <span class="anchor" id="line-43"></span>automatizzando task simili. Risolve inoltre anche il problema di condividere le <span class="anchor" id="line-44"></span>modifiche agli altri membri del team. <span class="anchor" id="line-45"></span><span class="anchor" id="line-46"></span><p class="line867"><a class="https" href="https://git.abbiamoundominio.org/subnixr/markdown-template" target="blank">Qui</a> <span class="anchor" id="line-47"></span>potete trovare uno scheletro di progetto pronto all'uso. <span class="anchor" id="line-48"></span><span class="anchor" id="line-49"></span><p class="line862">Grazie al <tt class="backtick">Makefile</tt>, che contiene le istruzioni giuste, ad ogni contributore <span class="anchor" id="line-50"></span>basa digitare nel terminare <tt class="backtick">make</tt> per compilare tutti i documenti, o <span class="anchor" id="line-51"></span><tt class="backtick">make&nbsp;NOME_SORGENTE.pdf</tt> per compilare il singolo file. <span class="anchor" id="line-52"></span><span class="anchor" id="line-53"></span><p class="line874">Make è anche inteligente: compila solo i file necessari, ottimizzando <span class="anchor" id="line-54"></span>sensibilmente i tempi. <span class="anchor" id="line-55"></span><span class="anchor" id="line-56"></span><p class="line867">
<h2 id="Zathura">Zathura</h2>
<span class="anchor" id="line-57"></span><p class="line874">Zathura [link] è un comodo lettore pdf per Linux. <span class="anchor" id="line-58"></span><span class="anchor" id="line-59"></span><p class="line874">Tra le sue feature, una è molto interessate: se il documento visualizzato viene <span class="anchor" id="line-60"></span>aggiornato, zathura in automatico lo ricarica. <span class="anchor" id="line-61"></span><span class="anchor" id="line-62"></span><p class="line874">È quindi possibile modificare il file con l'editor preferito e vedere il <span class="anchor" id="line-63"></span>risultato effettivo nel giro di un solo comando. Per chi ha esperienza, per una <span class="anchor" id="line-64"></span>automazione completa, consiglio di guardare la documentazione del proprio editor <span class="anchor" id="line-65"></span>per automatizzare l'esecuzione del comando <tt class="backtick">make</tt> al salvataggio. <span class="anchor" id="line-66"></span><span class="anchor" id="line-67"></span><p class="line867">
<h2 id="Ulteriori_risorse">Ulteriori risorse</h2>
<span class="anchor" id="line-68"></span><ul><li><p class="line891"><a class="https" href="https://fuoricampo.org/commonmark-buona.html" target="_blank">Scrivere e pubblicare in CommonMark alla buona</a> <span class="anchor" id="line-69"></span></li></ul><span class="anchor" id="bottom"></span></div>
</div>
<hr>
Ultimo cambiamento: 27-09-2020
</body>
</html>