Publication de page

[Discourse]

Ce guide explique comment utiliser la fonctionnalité de publication de pages (Page Publishing) sur Discourse. Cette fonctionnalité permet aux utilisateurs du personnel de convertir un sujet en une page statique autonome avec un style personnalisé. Des exemples incluent les pages de conditions d’utilisation et de politique de confidentialité.

Niveau utilisateur requis : Personnel

Publication de pages statiques sur Discourse

La publication de pages permet aux utilisateurs du personnel de créer des pages statiques autonomes à partir de sujets. Ceci est similaire au processus de création des pages de conditions d’utilisation ou de politique de confidentialité.

Résumé

Cette documentation couvrira :

• Activation de la publication de pages
• Publication d’un sujet en tant que page
• Dépublication d’un sujet
• Problèmes courants et solutions
• FAQ
• Ressources supplémentaires

Activation de la publication de pages

1. Accédez à Admin > Settings (Paramètres).
2. Activez le paramètre enable page publishing (activer la publication de pages).
   

Activation de la publication de pages lorsque la connexion est requise

Pour que les pages publiées soient visibles même lorsqu’un utilisateur n’est pas connecté :

1. Activez le paramètre show_published_pages_login_required sous Admin > Settings (Paramètres).
   

Publication d’un sujet

1. Allez au premier message d’un sujet public et sélectionnez l’icône d’ellipse (...).
   

2. Sélectionnez l’icône de clé à molette.
   

3. Choisissez l’option « Page Publishing » (Publication de page).
   

   

4. Une boîte de dialogue modale apparaîtra, vous permettant de confirmer le slug (qui peut être pré-rempli à partir du titre du message) et de prévisualiser l’URL de la page publiée.
   

   

Pour autoriser la publication de pages, il est nécessaire de désactiver les paramètres du site concernant les téléchargements sécurisés.

\u003csmall\u003e:information_source: Pour les sites hébergés, les téléchargements sécurisés sont limités au plan Entreprise.\u003c/small\u003e

Sujet publié

• Si l’option Public est cochée, une étiquette \u003ckbd\u003epublic\u003c/kbd\u003e apparaîtra.
  
  

  

• Un sujet publié affichera une notification sous le titre permettant d’accéder à ses paramètres de publication.
  

  

Page publiée

Dépublication d’un sujet

1. Sélectionnez Publishing Settings (Paramètres de publication) sous la notification.
   

   

2. Cliquez sur \u003ckbd\u003eUnpublish\u003c/kbd\u003e (Dépublier)
   

   

3. La page est dépubliée.
   

   

Problèmes courants et solutions

Impossible de voir les pages publiées lorsque l’on est déconnecté

Assurez-vous que le paramètre show_published_pages_login_required est activé dans Admin > Settings (Paramètres).

Ajouter un en-tête Discourse aux pages publiées

Actuellement, les pages statiques sont conçues pour être minimalistes et n’incluent pas l’en-tête et le pied de page typiques de Discourse.

FAQ

Puis-je rendre une page FAQ ou À propos publique ?

Vous pouvez créer un nouveau sujet avec le contenu souhaité et le publier en tant que page. Modifiez les liens dans les paramètres du site pour pointer vers ces nouvelles pages.

Comment puis-je personnaliser l’apparence d’une page publiée ?

Utilisez la structure du document HTML et les sélecteurs CSS correspondants pour appliquer des styles personnalisés sous Admin > Customize (Personnaliser) > Themes (Thèmes) > CSS.

Ressources supplémentaires

• Making custom CSS changes on your site
• Secure Uploads

[downey (Michael Downey)]

I still need to try this out first hand so the following may not be grounded in reality, but:

It strikes me that this permission model sets up a scenario where you always see two copies of the pages’ content – one in the relevant Discourse category, and one in the published pages themselves. This of course seems duplicative if you’re wanting to publish pages for the general population that is similar to, or identical to, your Discourse user base.

OTOH, if pages had the “world readable” flag available, you could then restrict who can see/edit them to a small group, and the only place the content would be available to other Discourse users would be in the published links themselves.

(I’m thinking of a use case of a “documentation site” here.)

Otherwise, I’m pretty excited to test things out!

[nathank (Nathan Kershaw)]

Awesome stuff, and thanks again for listening to your users. I love the ‘lets make this better for us all’ vibe that Discourse has! We’ll make heavy use of this.

When discussing one use (patching up an install that went a bit awry), another user pointed out a remaining bit of icing that could do with going on the cake:

@Paul_King

not sure why FAQ is omitted from sign up dialog, but you can also set this url here as well - though not sure purpose of this feild/what otherwise links to it if not included in signup dialog?

Hey, is there any way to include the ability to make /faq and /about public as well, as they are currently hidden in Login Required sites. We can of course use the existing functionality that you’ve just released for /faq by making our own, changing the link in settings, and explicitly linking to it. However, this is not pretty and the existing navigation to it remains hidden. We can’t do that at all for /about of course.

[core]

Something that would go nice with this feature is to make publications onebox-compatible such that people could easily share the content.

[DanDevine]

Please excuse my ignorance, as I am very much a beginner in the HTML/CSS space… however, how would we go about applying our theme colour choices to published pages. At its simplest, I’d like to use the dark background/white text to give the published pages the same darkmode experience as accessing our forums.

Is this already in the product, or do I need to play with HTML/CSS? If the latter, could anyone give me some pointers in the right direction? Thanks!

[j.jaffeux (Joffrey Jaffeux)]

@nathank

Hey, is there any way to include the ability to make /faq and /about public as well, as they are currently hidden in Login Required sites. We can of course use the existing functionality that you’ve just released for /faq by making our own, changing the link in settings, and explicitly linking to it. However, this is not pretty and the existing navigation to it remains hidden. We can’t do that at all for /about of course.

Can you make this a separate feature request please? This is not related to page publishing, as in I wouldn’t have to change anything related to page publishing to make it possible. I do agree it would be better if all these “static” pages could have more or less the same behaviour, but there are multiple solutions here (do nothing? add site settings? migrate these to page publishing?), so we might want to have a dedicated topic for this.

[Terrapop]

GTM not loaded on published pages? Would be nice.

[RGJ (Richard - Communiteq)]

@j.jaffeux

but wouldn’t that cause error with other themes trying to load code which is not available?

Hmm that is a really good point.

Just trying to think of a solution here… would it work if type="text/javascript" and type="text/discourse-plugin" were treated differently? The API needs the latter, right?

[j.jaffeux (Joffrey Jaffeux)]

Yes I think we already support having a text/javascript in the theme fields, so there are certainly solutions in this area.

[Terrapop]

That would be great.

[pfaffman (Jay Pfaffman)]

@j.jaffeux

at the moment page publishing is not designed to support theme components or anything using plugin api and especially decorateCooked.

So it’s currently impossible to have responsive published pages, and this site particularly wants

1. images made available when sharing to public media, and
2. responsive/resizing images displayed, especially on mobile–oh, mobile could just resize the image with CSS–that should work, right?

[syl]

+1 pour l’intégration de l’en-tête Discourse dans les pages publiées. Je regrette l’absence de mon logo de site web, de mes liens d’en-tête personnalisés et de mon menu hamburger tant apprécié

Autre bizarrerie : dans les messages, mes images en lightbox s’ouvrent dans une jolie fenêtre contextuelle, tandis que dans les pages publiées, elles s’ouvrent dans un nouvel onglet…

[pfaffman (Jay Pfaffman)]

Je pense qu’il faut un ensemble de composants de thème qui ajoutent cela. Le dernier client pour qui j’ai dû l’utiliser voulait supprimer le créateur de sujet. Je pense qu’il est difficile de deviner ce qui répondra aux besoins des gens à ce sujet !

[RGJ (Richard - Communiteq)]

Y a-t-il actuellement des initiatives en cours pour ajouter un support JavaScript « simple » (non-API) aux pages publiées ? Ou devrions-nous oublier cela à court ou moyen terme ?

[ddf]

Puis-je afficher du JSON externe non-Discourse sur cette page ? Comme nous ne pouvons pas utiliser de code PHP ici et que Discourse supprime la plupart du HTML, je ne sais pas comment procéder…

[Ed_Bobkov (Ed)]

J’ai un problème avec une page publiée : le bouton pour copier le contenu du bloc de code n’est pas visible sur la page publiée. Capture d’écran : Screenshot by Lightshot. Je passe la souris sur le bloc, mais le bouton n’apparaît pas. Une fois connecté, tout fonctionne normalement.

Quelqu’un peut-il reproduire le problème ? Une solution ?

[RGJ (Richard - Communiteq)]

Merci @riking !

Il semble en effet que le « texte » text/javascript « régulier » s’exécute sur les pages publiées lorsqu’il se trouve dans l’en-tête ou le pied de page d’un composant de thème.

[hellekin]

Ha ! Il semble donc qu’il existe une solution de contournement pour faire fonctionner certains composants de thème avec la publication de pages.

Je me penche sur l’ajout d’un en-tête ou d’un pied de page aux pages publiées, et les composants de thème semblent être la bonne approche. Mais il me semble risqué de mettre en œuvre quelque chose qui pourrait potentiellement être cassé dans un avenir proche.

@riking, il semble que le type text/javascript dans header ou footer fonctionnant sur les pages publiées était involontaire. Est-ce que cela va être corrigé ou utilisé pour étendre les pages publiées ?

@syl, l’auteur de DiscPage, a évoqué la possibilité de réimplémenter le plugin DiscPage en utilisant les fonctionnalités de publication de pages. Est-ce que tu as toujours cela en tête, @syl ? Selon toi, quelle serait la voie de moindre résistance pour intégrer les deux fonctionnalités, @riking ?

[syl]

@hellekin

@syl, l’auteur de DiscPage, a évoqué la possibilité de réimplémenter le plugin DiscPage en utilisant les fonctionnalités de Publication de pages. Avez-vous toujours ce projet à l’esprit, @syl ?

Malheureusement, la fonctionnalité « Publication de pages » ne répond pas à mes besoins. Pour que je puisse l’utiliser, les pages publiées devraient :

1. être affichées dans la mise en page normale de Discourse, c’est-à-dire avec l’en-tête standard de Discourse (tout comme les Conditions d’utilisation et la Politique de confidentialité), et
2. être rendues comme des sujets normaux (avec mise en forme), c’est-à-dire en prenant en charge le bbcode et les plugins.

[hellekin]

En attendant, j’ai utilisé l’outil de personnalisation par défaut de Discourse :

1. Identifier l’élément ajouté, par exemple avec une classe CSS published-page-footer-links.
2. Personnaliser le CSS pour masquer cet élément par défaut et ne l’afficher que sur les pages publiées.
3. Ajouter l’élément dans l’espace Footer.

2. Dans le CSS, ajoutez :

/* Afficher les liens du pied de page uniquement sur les pages publiées */
.published-page-footer-links { display: none; }
.published-page .published-page-footer-links { display: block;}

3. Dans Footer, ajoutez :

<nav class="published-page-footer-links">
Bonjour ! Ceci est le pied de page pour les pages publiées !
</nav>