-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathurna-pgmc-come-modificare-un-sito-winston-smith.html
167 lines (126 loc) · 8.1 KB
/
urna-pgmc-come-modificare-un-sito-winston-smith.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
<!DOCTYPE html>
<html lang="en">
<head>
<title>Urna — PGMC - come modificare un sito Winston Smith</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="shortcut icon" href="http://launchyard.com/images/favicon.png"/>
<link rel="stylesheet" href="./theme/css/main.css" type="text/css" />
<!--[if IE]>
<script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
<!--[if lte IE 7]>
<link rel="stylesheet" type="text/css" media="all" href="./css/ie.css"/>
<script src="./js/IE8.js" type="text/javascript"></script><![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" media="all" href="./css/ie6.css"/><![endif]-->
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.8/jquery.min.js" type="text/javascript"></script>
</head>
<body id="index" class="home">
<!-- <header id="banner" class="body">
<h1><a href="./"><img src="http://www.launchyard.com/images/logo.png" /><strong><a href="/" >URNA→</a> conserva le<br/>cose a cui<br/>Winston Smith<br/>tiene</strong></a></h1>
</header> -->
<!-- /#banner -->
<div class="LaunchyardDetail"><p><a href="./"></a><img src="./theme/images/urna.png" width="100%" height="100%" alt="URNA logo"></a><br/><a href="/" >URNA→</a> conserva le<br/>cose a cui<br/>Winston Smith<br/>tiene</p></div>
<section id="content" >
<div class="body">
<article>
<header>
<h1 class="entry-title">
<a href="./urna-pgmc-come-modificare-un-sito-winston-smith.html" rel="bookmark"
title="Permalink to Urna — PGMC - come modificare un sito Winston Smith">Urna — PGMC - come modificare un sito Winston Smith</a></h1>
</header>
<div class="entry-content">
<div class="post-info">
<ul>
<li class="vcard author">
by <a class="url fn" href="./author/winston-smith.html">Winston Smith</a>
</li>
<li class="published" title="2015-04-24T10:20:00+02:00">
on Fri 24 April 2015
</li>
</ul>
</div><!-- /.post-info --> <p>Per modificare uno dei siti Winston Smith realizzati con la catena PMGC è necessario:</p>
<ol>
<li>Clonare (o aggiornare) il repository sorgente sul proprio sistema</li>
<li>Modificare i file Markdown</li>
<li>Rigenerare i file statici html</li>
<li>Verificare il risultato</li>
<li>Aggiornare il repository sorgente</li>
</ol>
<p>Dopo la conclusione di quest'ultimo passo è possibile compiere i passi necessari alla
<a href="/urna-pgmc-come-pubblicare-un-sito-winston-smith.html">pubblicazione del sito su casellante</a></p>
<p>I repository sorgente di Winston Smith sono i seguenti:</p>
<ul>
<li><a href="https://github.com/progettowinstonsmith/bba-site">Big Brother Awards</a></li>
<li><a href="https://github.com/progettowinstonsmith/e-privacy-site">E-Privacy</a></li>
<li><a href="https://github.com/progettowinstonsmith/urna-site">URNA</a> (questo sito)</li>
<li><a href="https://github.com/progettowinstonsmith/antani-site">ANTANI</a> (sito di prova, facci quello che ti va)</li>
</ul>
<p>I collaboratori hanno accesso diretto ai repository e possono fare commit direttamente, gli altri possono comunque proporre pull-request.</p>
<h3>Clonare (o aggiornare) il repository sorgente sul proprio sistema</h3>
<p>Se non si ha una versione locale dei file di creazione del sito è possibile clonare il repository con il comando:</p>
<div class="highlight"><pre>git clone https://github.com/progettowinstonsmith/urna-site.git
</pre></div>
<p>Verrà creata una directory <code>urna-site</code> all'interno della quale, tra gli altri ci sono i seguenti file o directory:</p>
<p><code>pelicanconf.py</code>:
File di configurazione del sito</p>
<p><code>content</code>:
Directory contenente i documenti Markdown o i file statici del sito</p>
<p><code>theme</code>:
Directory contenente il <em>tema</em> di rappresentazione del sito</p>
<p>All'interno della directory dei contenuti (<code>content</code>) ci sono i file delle differenti pagine presenti nel sito, ad es:</p>
<div class="highlight"><pre><span class="nv">$ </span>ls -1 content/
attivazione-pelican-markdown.md
pmgc-modificare-siti.md
urna.md
</pre></div>
<p>Ciascuno di questi file rappresenta una pagina del sito in formato testuale <a href="http://daringfireball.net/projects/markdown/syntax">Markdown</a>.</p>
<p>Se si ha già una directory contenente il clone della directory di lavoro <em>è necessario</em> prima della sessione di lavoro aggiornare i propri file integrando le modifiche esterne con il comando:</p>
<div class="highlight"><pre>git pull
</pre></div>
<h3>Modificare i file Markdown</h3>
<p>I file Markdown devono essere creati o modificati usando un qualsiasi editor di testi (ad es. emacs o vi). Se si creano nuove pagine Markdown è sufficiente inserirle nella directory <code>content</code> per essere prese in considerazione per la pubblicazione, non è necessario aggiornare alcun elenco di pubblicazione.</p>
<h3>Rigenerare i file html</h3>
<p>Una volta modificata la pagina Markdown è possibile ricreare l'intero sito e tutte le sue pagine HTML usando il comando:</p>
<div class="highlight"><pre>make html
</pre></div>
<p>Il sistema risponderà con un messaggio simile:</p>
<div class="highlight"><pre><span class="n">Done</span><span class="o">:</span> <span class="n">Processed</span> <span class="mi">3</span> <span class="n">article</span><span class="o">(</span><span class="n">s</span><span class="o">),</span> <span class="mi">0</span> <span class="n">draft</span><span class="o">(</span><span class="n">s</span><span class="o">)</span> <span class="n">and</span> <span class="mi">0</span> <span class="n">page</span><span class="o">(</span><span class="n">s</span><span class="o">)</span> <span class="k">in</span> <span class="mf">0.19</span> <span class="n">seconds</span><span class="o">.</span>
</pre></div>
<h3>Verificare il risultato</h3>
<p>I file generati sono disponibili nella cartella output (per capire bene il funzionamento della directory <code>output</code> leggere il documento sulla <a href="">pubblicazione online</a> ).</p>
<p>Per verificare il risultato sulla macchina di lavoro è possibile lanciare un server HTTP locale con il comando:</p>
<div class="highlight"><pre>make serve
</pre></div>
<p>Un server verrà messo in esecuzione in modo sincrono e potrà essere verificato il contenuto del sito collegandosi al server (o a localhost) sulla porta 8000, ad es.:</p>
<div class="highlight"><pre>http://localhost:8000
</pre></div>
<p>Il sito dovrà risultare completamente funzionante e navigabile.</p>
<p>Per chiudere il server è sufficiente bloccare il comando con CTRL-C.</p>
<p>È anche possibile attivare un server in background con:</p>
<div class="highlight"><pre>make devserver
</pre></div>
<p>Che potrà essere abbattuto con il comando:</p>
<div class="highlight"><pre>make stopserver
</pre></div>
<h3>Aggiornare il repository sorgente</h3>
<p>Accertatisi della correttezza delle modifiche apportate è possibile aggiornare il repository sorgente con il comando:</p>
<div class="highlight"><pre>git pull
</pre></div>
<p>oppure preparando una pull-request nelle modalità solite.</p>
<h3>Pubblicazione del sito online</h3>
<p>Giunti a questo punto è possibile compiere di seguito i passi riportati nel documento di <a href="/urna-pgmc-come-pubblicare-un-sito-winston-smith.html">pubblicazione del sito su casellante</a></p>
</div><!-- /.entry-content -->
</article>
</div>
</section>
<section id="extras" >
</section><!-- /#extras -->
<footer id="contentinfo" >
<address id="about" class="vcard ">
Proudly powered by <a href="http://getpelican.com/" target="_blank">Pelican</a>, which takes
great advantage of <a href="http://python.org" target="_blank">Python</a>. © <a class="url fn" href="http://launchyard.com">LaunchYard</a>
</address><!-- /#about -->
</footer><!-- /#contentinfo -->
</body>
</html>