Stile del post del blog

[Discourse]

	Riepilogo	Blog Post Styling ti permette di designare una categoria blog, modificando l’aspetto dei topic all’interno di tale categoria per renderli simili a post di blog tradizionali.
	Anteprima	Anteprima su theme-creator.discourse.org
	Repository	github.com/discourse/discourse-blog-post-styling
	Nuovo a Discourse Themes?	Guida per principianti all’uso di Discourse Themes

Installa questo componente del tema

Il componente del tema Blog Post Styling trasforma i topic di Discourse in un layout tradizionale da post di blog. Quando applicato a una categoria, la prima immagine di ogni topic viene promossa a un’immagine hero a larghezza intera sopra il titolo, e il contenuto viene stilizzato con una tipografia e una visualizzazione dei metadati adatte ai blog.

Impostazioni

Di seguito sono riportate le varie impostazioni associate a questo componente del tema:

• Categoria blog: I topic che appartengono a una delle categorie selezionate avranno applicata la stilizzazione da post di blog.

• Tag blog: Scegli uno o più tag che, se applicati a un topic, gli conferiranno la stilizzazione da post di blog.

• Dimensione immagine: Decidi come l’immagine hero in evidenza riempie l’area dell’intestazione:

  • Nessuna immagine: Nascondi l’immagine in evidenza.
  • Larghezza intera (predefinita): L’immagine si estende su tutta l’area del contenuto.
  • Centrata: L’immagine mantiene il rapporto d’aspetto ed è centrata nell’area del contenuto.

• Posizione immagine: Decidi dove mostrare l’immagine rispetto al titolo:

  • Sopra il titolo (predefinito): Mostra l’immagine sopra il titolo del topic.
  • Sotto il titolo: Mostra l’immagine sotto il titolo del topic. Se selezionata, puoi anche includere un riassunto che viene visualizzato tra il titolo e l’immagine. Di seguito, puoi vedere come appare l’immagine quando l’impostazione posizione immagine è configurata su sopra il titolo e sotto il titolo:

• Dropcap abilitato: Se abilitato, la prima lettera del post di blog avrà uno stile ingrandito, come in questo esempio:
  
  
• Mobile abilitato: Se abilitato, la stilizzazione da post di blog viene applicata quando si legge il topic su dispositivi mobili.

Scrivere un post di blog

Una volta configurata la tua categoria blog (o applicato il tuo tag per post di blog), ci sono alcune cose particolari da notare sul funzionamento del topic del post di blog.

Immagine in evidenza

Posiziona l’immagine che desideri come immagine hero sulla prima riga in assoluto del post, seguita da una riga vuota prima dell’inizio del contenuto:

![descrizione immagine|1100x440](upload://hash-immagine.jpg)

Il contenuto del tuo post inizia qui...

Il componente posiziona automaticamente questa immagine in base all’impostazione posizione immagine (vedi sopra). Se qualsiasi altro contenuto — incluse righe vuote — appare prima dell’immagine, questa non verrà promossa alla posizione hero.

Dopo aver pubblicato per la prima volta un post, aggiorna la pagina per vedere l’immagine apparire nella posizione designata. (Questo influisce solo sull’autore del post alla pubblicazione iniziale; i membri che accedono al post dovrebbero vedere l’immagine nel posto giusto immediatamente.)

Suggerimenti per il ridimensionamento delle immagini

Il contenitore dell’immagine è alto 440px e largo 100%. Per i migliori risultati quando l’impostazione dimensione immagine è impostata su larghezza intera:

• Usa o ritaglia le immagini a 1100x400px prima del caricamento per evitare ritagli, oppure
• Scegli immagini con un soggetto centralizzato o contenuti non specifici (paesaggi, motivi) in modo che i ritagli non rimuovano dettagli importanti.

Riassunti

Quando l’impostazione posizione immagine è impostata su sotto il titolo, puoi aggiungere un riassunto opzionale al tuo post di blog, che apparirà tra il titolo e l’immagine in evidenza.

Per fare ciò, avvolgi il contenuto che desideri includere nel riassunto come segue:

[summary] Ecco il contenuto che sarà il tuo riassunto. [/summary]

Blockquote stilizzati

Quando crei topic in una categoria blog, i blockquote ricevono una stilizzazione speciale. Puoi creare blockquote nel composer usando il simbolo > o il pulsante della barra degli strumenti del composer <kbd>“</kbd>.

Impostazione categoria consigliata

Nelle impostazioni della tua categoria blog, considera di abilitare l’impostazione categoria Vai al primo post dopo la lettura dei topic. Questo invia i lettori abituali direttamente al contenuto del post di blog anziché alla loro ultima posizione di lettura.

Blog Post Styling + Miniature nell’elenco dei topic

Questo componente è compatibile con Topic List Thumbnails, che evidenzia l’immagine in evidenza del tuo post di blog nell’elenco dei topic:

Nota: Il componente Topic List Thumbnails non è compatibile con il tema Horizon. Lo screenshot sopra è stato realizzato utilizzando il tema Foundation.

[amotl (Andreas Motl)]

@amotl

After bumping the defined sizes manually just slightly in the markup, the headline-image-expansion feature works flawlessly – [at least with] images [that] are actually large enough (> 690px wide).

We just have been able to verify that by bumping the original markup materialized after upload by just injecting a zoom level of 101% at the appropriate place like

![image|690x458,101%](upload://4BWmapYzkwTQrWlm1JkeUwefYrC.jpeg)

after the respective image had been uploaded beforehand as

![image|690x458](upload://4BWmapYzkwTQrWlm1JkeUwefYrC.jpeg)

This is cute and makes us happy.

---

JeeLink

[ohellno]

Hello, and thank you very much for dedicating the time to create this and release it for free.

I was just wondering if it would be at all possible to change this somehow to use a specific tag instead of a particular category?

I just setup a new discourse website but I’ve been writing a lot of “blog posts” but I would still like these to show up in the appropriate other categories in order to make it seem a little more integrated.

Currently I have been posting them in their own blog-posts category, which I limited to just me being able to post in there, but I just setup a tag group and made that only accessible to staff.

Thanks again!

[Howaids (Martin)]

Thanks very much @tshenry. Your theme components have all been spot on.And to @sam and @codinghorror for sharing an incredible app!! Your generosity including the support in meta is heartfelt. Discourse is indeed made for the more caring internet of the future.

[LoganRTW (Ward)]

Is there a way to make this work with a video as the featured content rather than the image? I would delete my wordpress site if I could just post the YouTube/Vimeo etc. and have that be the top content. Any ideas?

[Howaids (Martin)]

Totally! Great suggestion @LoganRTW. It’s got my vote @tshenry. Can it be done?

[tshenry (Taylor)]

Update

If you can believe it

I have started refactoring/cleaning up the component to use the plugin-style file structure and make use of the new topic thumbnails.

https://github.com/discourse/discourse/pull/9215

I’ve added a couple new features as well:

• New settings

  • image_display_style - there are two options with this. The default should be the behavior the component has had all along. The alternative will ensure there is no cropping and the full image is displayed. It’s hard to say which one is “better” so you’ll want to do some experimentation and see what works best for your workflow and blog images.

    

  • mobile_enabled - this is a first pass on the mobile blog post style. I’m interested to hear any bug reports or ideas for improvements on this!

    

I still want to continue refactoring and cleaning up the code, but this should be a good start.

https://github.com/tshenry/discourse-blog-post-styling/commit/eba3c52fc1f9b273d34e9d673567410e4566372e

---

@Varhall

It would be cool to add schema.org markup for this type of topic. There is in the plans?

No plans at this point, I’m afraid!

[torstensson (Per Torstensson)]

Thank you for a really inspiring and nice component @tshenry

In my evaluation I have identified two issues;

1. No blog image in sub categories - after quite extensive troubleshooting with different themes and enabling/disabling both plugins and other components, I think I can state with near certainty that blog images won’t render for sub categories. The first image/the intended blog image is however still hidden.

2. First image not hidden inline with DiscoTOC - When Blog Post Styling is used together with DiscoTOC, the blog image get rendered above the title correctly - however, it is rendered twice as it is still rendered in its original position as well.

[tshenry (Taylor)]

Thanks so much for the feedback @torstensson! Both points were indeed bugs and should now be fixed:

Bug fixes

Please let me know if you continue to have any issues.

---

To everyone using this component:

If you are not currently including a featured image at the top of all blog posts, this is for you!

This component was created with the intention of having an image display above every blog post topic. With that said, it was possible to create a blog post without displaying a featured image by simply not including an image on the first line of the post. This behavior has changed.

The newer implementation greatly improves performance, but it uses a predefined value rather than looking at the post contents itself. The predefined value is generated from the first image found in the post. Unlike before, it is not necessarily limited to an image appearing as the first line of the post. This means if you create a post without an image on the first line, but you include a single image at the bottom of the post, that image at the bottom will now also be displayed above the topic.

I have included an all-or-nothing setting that can toggle on/off the “featured image,” allowing you to have all of the styling except for the featured image if that is your preference.

I am going to update the OP with all of the new considerations and recommendations, but the short of it is to make sure to include an image on the first line of the post (this positioning is still used to make sure the image is not repeated). You may find it is helpful to use a placeholder image in the category’s topic template that can be used as a default if no image is provided.

[torstensson (Per Torstensson)]

@tshenry

Thanks so much for the feedback @torstensson! Both points were indeed bugs and should now be fixed. Please let me know if you continue to have any issues.

Awesome, thank you @tshenry I can gladly confirm that both issues have been resolved with the update and again - thank you for a really great component, not only in function but inspiration as well

[core]

A recently announced feature may work as an alternative to this theme-component. Leaving it here for those interested.

Page Publishing

This guide covers how to use the Page Publishing feature on Discourse. This feature allows Staff/Admin users to convert a topic into a standalone static page with custom styling. Examples include the Terms of Service and Privacy Policy pages. Required user level: Admin Publishing static pages on Discourse Page Publishing allows Admin users to create standalone static pages from topics. This is similar to the process for creating Terms of Service or Privacy P…

[nityeshaga (Nityesh Agarwal)]

@tshenry Grazie mille per questo componente! Lo stiamo utilizzando insieme al plugin Topic List Previews per creare una sezione Articoli per gli studenti nella Community di Dataquest.

Ho una richiesta di funzionalità da considerare nelle future iterazioni di questo componente: potresti aggiungere la possibilità di inserire URL canonici negli articoli?

I motori di ricerca utilizzano i link canonici per determinare e dare priorità alla fonte definitiva dei contenuti, eliminando confusione quando esistono copie multiple dello stesso documento in posizioni diverse.

Grazie!

[sebastianh (Rebastion)]

Quindi penso che questo sia un ottimo componente. In realtà, lo sto già provando su un Discourse attivo e sto sperimentando con esso. Senza un ordine particolare, vorrei condividere i miei primi pensieri e feedback, spero che siano utili: scusate se alcune di queste osservazioni sono più delle domande:

• Il modo in cui viene mostrato l’autore è un po’ fuori luogo e potrebbe essere risolto in modo più efficiente in termini di spazio, per integrarlo meglio con il titolo, il tag della categoria, ecc… C’è anche troppo spazio bianco tra la riga che conclude le informazioni sull’autore e l’inizio del testo.
• È difficile per un visitatore arrivato direttamente a un post del blog capire dove si trova, poiché non c’è una chiara breadcrumb o qualcosa di simile. Il motivo principale è che la barra del titolo sembra essere disattivata, mentre nei topic normali si trasforma e include il titolo, la categoria, ecc.
• Sarebbe fantastico se la visualizzazione delle categorie potesse avere un aspetto più da blog, con piccole immagini di anteprima e simili; sarebbe difficile farlo?
• Non vedo una descrizione della categoria nella visualizzazione delle categorie?

[sebastianh (Rebastion)]

@nityeshaga

an Sezione Articoli per studenti nella Community di Dataquest.

wow, quale componente del tema è stato utilizzato per quella vista delle categorie? Sembra figo

[tshenry (Taylor)]

Grazie per il feedback

@sebastianh

• Il modo in cui viene visualizzato l’autore è un po’ fuori luogo e potrebbe essere risolto in modo più efficiente dal punto di vista dello spazio, per integrarlo meglio con il titolo, il tag della categoria, ecc… C’è anche molto spazio bianco tra la riga che conclude le informazioni sull’autore e l’inizio del testo.

Concordo sul fatto che ci sia molto spazio bianco intorno all’area autore/titolo. Terrò presente questo feedback la prossima volta che lavorerò sul componente e vedrò se riesco a trovare una soluzione.

@sebastianh

È difficile per un visitatore indirizzato direttamente a un post del blog capire dove si trova, poiché non c’è un percorso di navigazione chiaro o qualcosa di simile. Il motivo principale è che la barra del titolo sembra essere disattivata, mentre nei topic normali si trasforma e include il titolo, la categoria, ecc.

Non sono sicuro al 100% di cosa intendiate qui. L’intestazione cambierà per includere il titolo e il percorso di navigazione non appena scorrerete verso il basso oltre l’immagine e il titolo del blog. Avete ragione nel dire che, nella parte superiore della pagina, non è particolarmente evidente, però. Terrò anche questo a mente.

@sebastianh

• Sarebbe fantastico se la visualizzazione delle categorie avesse un aspetto più da blog, con piccole anteprime delle immagini e simili. Sarebbe difficile da realizzare?
• Non vedo una descrizione della categoria nella visualizzazione delle categorie?

Queste funzionalità esulano dall’ambito di questo componente. Per la visualizzazione delle categorie, potreste dare un’occhiata a: Topic List Thumbnails

[sebastianh (Rebastion)]

Grazie per il feedback Penso che la maggior parte sia stata chiarita e ora vedo anche la descrizione della categoria, non sono sicuro del perché non fosse visibile prima, pensavo avesse a che fare con il componente. Continuerò a provarlo e pubblicherò altri feedback più tardi. Ottimo lavoro!

[sebastianh (Rebastion)]

Penso che lo spazio in eccesso in alto provenga dallo spazio rimasto dopo che l’immagine è stata “spostata” nell’intestazione del post del blog, risultando non in uno spazio guadagnato sotto, ma in uno spazio vuoto.

Ma ho notato un problema reale: se pubblico link a un tale post del blog in altri argomenti, non c’è nessuna anteprima, vedi qui

[sebastianh (Rebastion)]

@sebastianh

Penso che lo spazio in eccesso in alto derivi dallo spazio residuo dopo che l’immagine è stata “spostata” nell’intestazione del post del blog, risultando non in uno spazio guadagnato sotto, ma in un’area vuota.

Ecco uno screenshot di ciò che intendo:

[tshenry (Taylor)]

Sono abbastanza sicuro che ciò sia dovuto all’assenza di un’interruzione di riga tra il link per il caricamento dell’immagine e il primo paragrafo. Puoi provare a modificarlo in modo che corrisponda al seguente:

![spagh|690x390](upload://nVi42gGIwt03DAYSzVEc4RvwS6h.jpeg) 

<big>Sebbene</big> ci sia ampio spazio sul web per pubblicare, scrivere blog, condividere e twittare e via dicendo, il mio luogo preferito per scambiare idee con tutti voi sul western spaghetti è questo forum. Alcuni di voi potrebbero ricordare uno sforzo risalente a diversi anni fa, chiamato "Planet Spaghetti Western", l'idea era quella di avere un blog che avrebbe aggregato automaticamente i post da tutti i blog sul western spaghetti presenti su internet, presentandoli in una sorta di riassunto. Era piuttosto complicato dal punto di vista tecnico e alla fine richiedeva più lavoro di quanto ne valesse la pena, quindi ho dovuto chiudere quel progetto.

Se funziona, aggiungerò una nota nell’OP riguardo a questo requisito.

[sebastianh (Rebastion)]

Ciao. Questo riduce un po’ il margine, effettivamente, grazie. Nel editor avevo fatto esattamente l’opposto: lasciare il meno spazio possibile tra l’immagine e l’inizio del testo.