Your Name — Resume & Blog

Cinque cose da controllare prima di pubblicare

Fri, 15 Mar 2024 09:00:00 +0100

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Prima di puntare un dominio su questo sito e dire che è finito, vale la pena ripassare una breve lista.

Identità del sito. Il blocco title, description e author in _config.yml — i segnaposto sono chiaramente segnaposto, ma è facile dimenticarne uno.
Pagine legali. disclaimer.md e privacy.md nella root del repository arrivano con note su cosa metterci davvero, non testo legale reale.
Immagini di copertina. I post funzionano bene anche senza image, ma l’indice del blog e il post in evidenza rendono meglio con una.
Link di esempio rimasti. I post di esempio (questo incluso) fanno riferimento al repository di questo tema e ai contenuti dimostrativi — sostituiscili o rimuovili una volta letto cosa mostrano.
Un dominio personalizzato, se lo usi. Vedi la sezione “Deploying to GitHub Pages” del README per la combinazione url/baseurl giusta per la tua configurazione.

Nessuno di questi punti impedisce al sito di compilare — Jekyll non si lamenta di un author.name segnaposto. Sono solo cose facili da dimenticare proprio perché niente si rompe se lo fai.

Five Things to Check Before You Launch

Fri, 15 Mar 2024 09:00:00 +0100

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Before you point a domain at this and call it done, it’s worth running through a short list.

Site identity. _config.yml’s title, description, and author block — the placeholders are obviously placeholders, but it’s easy to miss one.
Legal pages. disclaimer.md and privacy.md at the repo root ship with notes on what to actually put there, not real legal text.
Cover images. Posts render fine without an image, but the blog index and the featured post both look better with one.
Broken example links. The two example posts (this one included) reference this theme’s own repo and demo content — replace or remove them once you’ve read what they’re showing.
A custom domain, if you’re using one. See the README’s “Deploying to GitHub Pages” section for the url/baseurl combination that applies to your setup.

None of these will stop the site from building — Jekyll won’t complain about a placeholder author.name. They’re just easy to forget precisely because nothing breaks if you do.

Markdown e stili in questo tema

Fri, 01 Mar 2024 09:00:00 +0100

Lorem ipsum dolor sit amet, testo in grassetto, testo in corsivo e codice inline vengono renderizzati come ti aspetti. I link appaiono così e prendono il colore d’accento.

Titoli

Questo post usa ## e ### — # (h1) è riservato al titolo del post stesso, impostato dal campo title nel front matter, non scritto nel corpo.

Un titolo più piccolo

I titoli hanno una spaziatura coerente sopra e sotto, quindi non serve aggiungere interruzioni di riga manuali fra le sezioni.

Elenchi

Non ordinato:

Primo elemento
Secondo elemento, con un elenco annidato:
- Elemento annidato uno
- Elemento annidato due
Terzo elemento

Ordinato:

Installa Ruby e Bundler
Esegui bundle install
Esegui bundle exec jekyll serve

Citazioni

Una blockquote ha un bordo a sinistra e testo attenuato — utile per citazioni in evidenza o per citare una fonte.

Codice

Il codice inline come page.title sta dentro una pillola. I blocchi di codice recintati ottengono l’evidenziazione della sintassi tramite Rouge, l’highlighter incluso in questo tema:

title: "Il mio post"
date: '2024-03-01 09:00:00'
categories:
- Guide
tags:
- esempio

{% for post in site.posts %}
  {{ post.title }}
{% endfor %}

Tabelle

Campo	Obbligatorio	Note
`title`	Sì	Mostrato come H1 del post
`date`	Sì	Usato anche per l’ordinamento e la stima del “tempo di lettura”
`image`	No	Foto di copertina; abbinala a `image_dark` per una versione theme-adaptive

Immagini

.prose limita la larghezza delle immagini al 100% della colonna di lettura e ne arrotonda gli angoli — nessuna classe aggiuntiva necessaria:

Questo è il set completo. Combinali come preferisci — nessuno è obbligatorio, e anche semplici paragrafi di testo funzionano bene quanto tutto il resto.

Markdown & Styles in This Theme

Fri, 01 Mar 2024 09:00:00 +0100

Lorem ipsum dolor sit amet, bold text, italic text, and inline code all render the way you’d expect. Links look like this one and pick up the accent color.

Headings

This post uses ## and ### — # (h1) is reserved for the post title itself, set from the title front matter field, not written in the body.

A smaller heading

Headings get consistent spacing above and below, so you don’t need to add manual line breaks between sections.

Lists

Unordered:

First item
Second item, with a nested list:
- Nested item one
- Nested item two
Third item

Ordered:

Install Ruby and Bundler
Run bundle install
Run bundle exec jekyll serve

Quotes

A blockquote gets a left border and muted text — useful for pull quotes or for quoting a source.

Code

Inline code like page.title sits in a pill of its own. Fenced code blocks get syntax highlighting via Rouge, the highlighter this theme ships with:

title: "My Post"
date: '2024-03-01 09:00:00'
categories:
- Guides
tags:
- example

{% for post in site.posts %}
  {{ post.title }}
{% endfor %}

Tables

Field	Required	Notes
`title`	Yes	Shown as the post’s H1
`date`	Yes	Also used for sorting and the “reading time” estimate
`image`	No	Cover photo; pair with `image_dark` for a theme-adaptive version

Images

.prose caps image width at 100% of the reading column and rounds the corners — no extra classes needed:

That’s the full set. Mix and match as needed — none of it is required, and plain paragraphs of text work just as well as everything above.

A Second Example Post (No Translation)

Thu, 15 Feb 2024 09:00:00 +0100

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla facilisi. Vivamus lacinia odio vitae vestibulum vestibulum. Cras porttitor metus justo, quis auctor massa condimentum a.

Why untranslated posts are fine
Adding a translation later

Why untranslated posts are fine

On a real site you’ll often publish faster than you can translate, or some posts just won’t be relevant to a second-language audience. This theme handles that gracefully:

A post without translation_key in its front matter has no language switcher — visitors won’t be offered a version that doesn’t exist.
It only shows up in the blog index, category page, and search results of its own language.
Related posts (shown at the bottom of an article) are only ever suggested in the same language.

Adding a translation later

If you do translate a post later, just add a matching translation_key to both files’ front matter and the switcher appears automatically — no other change needed.

translation_key: my-shared-key

Aenean lacinia bibendum nulla sed consectetur. Donec sed odio dui. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

Benvenuti in questo tema

Mon, 01 Jan 2024 10:00:00 +0100

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Una sezione di esempio
Blocchi di codice
Un’altra sezione

Una sezione di esempio

Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Punto elenco uno
Punto elenco due
Punto elenco tre

Blocchi di codice

Anche i blocchi di codice sono già stilizzati (via Rouge):

echo "Sostituisci questo con i tuoi esempi reali"

Un’altra sezione

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.

Questo post esiste anche in inglese — collegato tramite lo stesso translation_key nel front matter, che è quello che attiva lo switcher lingua qui sopra nella nav.

Welcome to This Theme

Mon, 01 Jan 2024 10:00:00 +0100

An example section
Code blocks
Another section

An example section

Bullet point one
Bullet point two
Bullet point three

Code blocks

Code blocks are already styled out of the box (via Rouge):

echo "Replace this with your own real examples"

Another section

This post also exists in Italian — linked via the same translation_key in front matter, which is what powers the language switcher up in the nav.