davidbgk
/
larlet-fr-david

<!doctype html>
<html lang=fr>
<head>
  <!-- Always define the charset before the title -->
  <meta charset=utf-8>
  <title>Ajout des flux RSS, du sitemap et des commentaires avec Django — Biologeek — David Larlet</title>
  <!-- Define a viewport to mobile devices to use - telling the browser to assume that the page is as wide as the device (width=device-width) and setting the initial page zoom level to be 1 (initial-scale=1.0) -->
  <meta name="viewport" content="width=device-width, initial-scale=1"/>
  <!-- Fake favicon, to avoid extra request to the server -->
  <link rel="icon" href="data:;base64,iVBORw0KGgo=">
  <link type="application/atom+xml" rel="alternate" title="Feed" href="/david/log/" />
  <link rel="manifest" href="/manifest.json">
  
  <link rel="stylesheet" href="/static/david/css/larlet-david-_J6Rv.css" data-instant-track />
  
  <noscript>
    <style type="text/css">
      /* Otherwise fonts are loaded by JS for faster initial rendering. See scripts at the bottom. */
      body {
        font-family: 'EquityTextB', serif;
      }
      h1, h2, h3, h4, h5, h6, time, nav a, nav a:link, nav a:visited {
        font-family: 'EquityCapsB', sans-serif;
        font-variant: normal;
      }
    </style>
  </noscript>
  
  <!-- Canonical URL for SEO purposes -->
  <link rel="canonical" href="https://larlet.fr/david/biologeek/archives/20070623-ajout-des-flux-rss-du-sitemap-et-des-commentaires-avec-django">

</head>
<body>
  <div>
    
    <header>
      <nav>
        <p>
          <small>
            Je suis <a href="/david/" title="Profil public">David Larlet</a>, <a href="/david/pro/" title="Activité professionnelle">artisan</a> du web qui vous <a href="/david/pro/accompagnement/" title="Activité d’accompagnement">accompagne</a><span class="more-infos"> dans l’acquisition de savoirs pour concevoir des <a href="/david/pro/produits-essentiels/" title="Qu’est-ce qu’un produit essentiel ?">produits essentiels</a></span>. <span class="more-more-infos">Discutons ensemble d’une <a href="/david/pro/devis/" title="En savoir plus">non-demande de devis</a>.</span> Je partage ici mes <a href="/david/blog/" title="Expériences bienveillantes">réflexions</a> et <a href="/david/correspondances/2017/" title="Lettres hebdomadaires">correspondances</a>.
          </small>
        </p>
      </nav>
    </header>
    
    
  <section>
    <h1 property="schema:name">Ajout des flux RSS, du sitemap et des commentaires avec Django</h1>
    <article typeof="schema:BlogPosting">
      <div property="schema:articleBody">
        <img src="/static/david/biologeek/images/logos/biologeek.png" alt="vignette" style="float:left; margin: 0.5em 1em;" property="schema:thumbnailUrl" />
        <p>Suite de la <a href="https://larlet.fr/david/biologeek/archives/20070224-objectifs-et-motivations-de-la-refonte-de-ce-blog/">refonte de ce blog</a> qui commence vraiment à trainer en longueur... il faut dire que ça me prend souvent plus de temps de décrire ce qui est fait que de le coder&nbsp;! Du coup c'est probablement le dernier billet à ce sujet. De toute façon c'est presque terminé, il ne me reste plus qu'à mettre quelques surprises et à adapter le thème, voire peut-être à tenter un <a href="http://forum.alsacreations.com/concours/cssr2007/">Cascading Style Summer Refresh 2007</a> mais j'en doute car je vais manquer de temps ces prochains mois.</p>

<h2>Ajout des flux RSS et Atom</h2>

<p>J'essaye toujours d'<strong>utiliser au maximum les fonctionnalités offertes par Django</strong> qui suit la philosophie Python «&nbsp;batteries incluses ». Dans le cas des flux je voulais quelque chose de très spécifique donc il a fallu mettre un peu les mains dans le cambouis mais c'est ce qui fait le charme d'un framework&nbsp;: <strong>on peut tout contrôler</strong>&nbsp;!</p>

<p>On commence par le cahier des charges, le but était d'avoir des URL du type <strong>/abonnement/{ rss, atom }/{journal, bistrot, tag, liste de tags }/</strong> afin de laisser la possibilité d'utiliser soit RSS, soit Atom tout en ayant des URL relativement courtes et compréhensibles. Au niveau du fichier des URL on retrouve donc&nbsp;:</p>

<pre>from biologeek.feeds import RSSFeed, AtomFeed

urlpatterns += patterns('django.contrib.syndication.views',
    (r'^abonnement/(?P&lt;url&gt;.*)/$', 'feed',
        {'feed_dict': { 'rss': RSSFeed, 'atom': AtomFeed }}
    ),
)</pre>

<p>Les clés du dictionnaire <strong>feed_dict</strong> vont être passées en paramètre de la fonction feed pour se retrouver dans l'URL donc jusqu'ici on a <strong>/abonnement/{ rss, atom }/</strong>. C'est ensuite au niveau des classes RSSFeed et AtomFeed qu'il faut décider du contenu qui va être proposé&nbsp;:</p>

<pre>from django.contrib.syndication.feeds import Feed
from biologeek.journal.models import Post

class RSSFeed(Feed):
    description = u'Dernières mises à jour du site de David Larlet : biologeek.com relatives aux %s'
    author_name = 'David Larlet'
    author_link = 'http://larlet.fr/'
    copyright   = 'Copyright (c) 2004-2007, David Larlet, Licence Art Libre'

    def get_object(self, bits):
        if len(bits) == 1:
            bit = bits[0]
            if bit == 'journal':
                self.title = 'Flux RSS des billets du journal du site biologeek.com'
                self.link = '/journal/'
                self.description = self.description % u'billets du journal'
                return Post.published.all()[:25]

            [...]

            else:
                raise ObjectDoesNotExist

    def items(self, obj):
        return obj</pre>

<p>Je ne mets pas tout mais vous aurez compris le principe (si non <a href="http://code.google.com/p/biologeek/">vous pouvez récupérer les sources sur le dépôt</a>). En fonction de la valeur passée en URL, un contenu approprié est proposé. C'est pas vraiment élégant et cela tient au cahier des charges un peu spécial que je m'étais fixé, sinon c'est beaucoup plus simple comme vous pouvez le voir <a href="http://www.djangoproject.com/documentation/syndication_feeds/">dans la documentation</a>.</p>

<p>Lorsque l'on veut passer au flux Atom, il suffit d'hériter de la classe utilisée pour le RSS&nbsp;:</p>

<pre>from django.utils.feedgenerator import Atom1Feed

class AtomFeed(RSSFeed):
    feed_type = Atom1Feed
    subtitle = RSSFeed.description</pre>

<h2>Ajout d'un sitemap</h2>

<p><strong>Un <a href="http://www.sitemaps.org/fr/">sitemap</a> est une aide pour les moteurs de recherche</strong>. C'est un fichier xml permettant d'indiquer l'importance relative des pages du site et leur fréquence de mise à jour. Il est généralement placé sur <strong>/sitemap.xml</strong> et il est nécessaire de <a href="http://www.google.com/webmasters/sitemaps/?hl=fr">le déclarer pour qu'il soit indexé</a>. On va ici se servir du <a href="http://www.djangoproject.com/documentation/sitemaps/">module sitemap de Django</a>, on rajoute donc l'URL&nbsp;:</p>

<pre>from biologeek.sitemaps import sitemaps

urlpatterns += patterns('django.contrib.sitemaps.views',
    (r'^sitemap.xml$', 'sitemap', {'sitemaps': sitemaps})
)</pre>

<p>La gestion des sitemaps peut se faire de manière générique, ce qui est très pratique pour les modèles que j'ai choisi&nbsp;:</p>

<pre>from django.contrib.sitemaps import GenericSitemap
from biologeek.journal.models import Post

sitemaps = {
    'journal_bestof': GenericSitemap(
        {
            'queryset': Post.published.filter(is_bestof=True),
            'date_field': 'publication_date'
        },
        priority=0.6
    ),
    'journal': GenericSitemap(
        {
            'queryset': Post.published.exclude(is_bestof=False),
            'date_field': 'publication_date'
        },
        priority=0.4
    ),
    [...]
}</pre>

<p>Par contre j'ai pas mal cherché pour arriver à rajouter les liens qui ne sont pas inhérents à des modèles comme l'accueil ou les pages d'agrégation de ressources. J'ai finalement créé une classe dédiée à ça&nbsp;:</p>

<pre>from django.contrib.sitemaps import Sitemap

class BaseSitemap(Sitemap):
    priority = 0.8

    def items(self):
        return ['/', '/journal/', '/bistrot/', '/archives/', '/abonnement/', '/contact/']

    def location(self, obj):
        return obj</pre>

<p>qu'il suffit ensuite d'ajouter au dictionnaire précédent. Comme vous pouvez le remarquer, je ne spécifie pas la fréquence de mise à jour car les pages de ressources sont susceptibles d'évoluer au cours du temps grâce aux commentaires et celles d'agrégations sont mises à jour de façon non régulière compte tenu de mon rythme de publication. <strong>Dans le doute, il vaut mieux s'abstenir Google saura mieux algorithmer tout ça que vous.</strong></p>

<h2>Ajout des commentaires</h2>

<p>Comme je le disais plus haut j'aime bien utiliser les modules déjà inclus dans Django. Pour les commentaires, <strong>je vais peut-être faire une petite exception pour deux raisons</strong>&nbsp;:</p>

<ul>
<li>même s'il est très puissant (peut-être trop d'ailleurs pour mes besoins&nbsp;: karma, etc), il est <strong>très peu extensible</strong> en l'état et doit être réécrit pour ça&nbsp;;</li>
<li>il utilise les <strong>anciens formulaires</strong> et je ne trouve pas intéressant de continuer à les utiliser aujourd'hui.</li>
</ul>

<p>Je n'ai pas encore décidé de ce que j'allais faire. Il me reste aussi à intégrer l'<a href="https://larlet.fr/david/biologeek/archives/20070104-comment-utiliser-openid-la-solution-d-identification-tant-attendue/">identification via OpenID</a> pour vous rendre la vie plus facile :-).</p>

<p>Prochaine étape... euh... <strong>la mise en ligne</strong>&nbsp;! J'ai pas mal galéré pour <a href="http://www.django-fr.org/">Django-fr</a> donc ça devrait aller beaucoup plus vite.</p>
      </div>
    </article>
    <footer>
      <h6 property="schema:datePublished">— 23/06/2007</h6>
    </footer>
  </section>
  <section>
    <div>
      <h3>Articles peut-être en rapport</h3>
      <ul>
        <li><a href="/david/biologeek/archives/20080423-biologeek-enfin-propulse-par-django/" title="Accès à Biologeek (enfin) propulsé par Django">Biologeek (enfin) propulsé par Django</a></li>
        <li><a href="/david/biologeek/archives/20070523-de-dotclear-a-django-migration-des-donnees-et-redirections/" title="Accès à De Dotclear à Django : migration des données et redirections">De Dotclear à Django : migration des données et redirections</a></li>
        <li><a href="/david/biologeek/archives/20070424-vues-generiques-heritage-et-templatetags-developpez-rapidement-avec-django/" title="Accès à Vues génériques, héritage et templatetags : développez rapidement avec Django">Vues génériques, héritage et templatetags : développez rapidement avec Django</a></li>
      </ul>
    </div>
  </section>
  <section>
    <div id="comments">
      <h3>Commentaires</h3>
      
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">zyegfryed</span> le <span class="comment-date" property="schema:commentTime">23/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Salut,<br />
Excellent article, dont la collection devrait figurer quelque part sur django-fr.org ! (Cela n'engage que moi, bien sur :))<br />
Je pense avoir remarqué une coquille dans le code mentionné sur l'article (je n'ai par contre pas vérifié les sources, tu me pardonneras), au niveau de la définition des éléments du sitemap :<br />
<br />
    'journal': GenericSitemap(<br />
        {<br />
            'queryset': Post.published.exclude(is_bestof=False),<br />
            'date_field': 'publication_date'<br />
        },<br />
        priority=0.4<br />
    ),<br />
<br />
Il me semble que la valeur de is_bestof doit être à True, puisque l'on cherche à exclure les billets BestOf qui possèdent déja leur propre référence, non ?<br />
<br />
Sinon, j'avais vu dans ton code source au niveau du modèle de billet (class Post il me semble) que tu utilisais un conteneur pour chaque élément formaté (Textile, Markdown, Dotclear, etc...). Ne serait il pas plus &quot;convenable&quot; de n'utiliser qu'un seul champ contenant le texte formaté, à l'aide du snippet Generic markup converter (<a href="http://www.djangosnippets.org/snippets/104/" title="http://www.djangosnippets.org/snippets/104/" rel="nofollow">www.djangosnippets.org/sn...</a>) de James Bennett (ubernostrum) ? (Modulo adaptation afin que la variable markup_func_name ne se base plus que sur une variable de configuration, mais puisse être surchargée via les paramètres kwargs par exemple ou un attribut de classe).<br />
Bye :)<br />
Seb</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">23/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Salut Seb,<br />
<br />
&gt; Excellent article, dont la collection devrait figurer quelque part sur django-fr.org !<br />
<br />
J'y penserais, j'attends d'avoir une catégorie Django bien définie pour poster le lien vers celle-ci.<br />
<br />
&gt; Il me semble que la valeur de is_bestof doit être à True, puisque l'on cherche à exclure les billets BestOf qui possèdent déja leur propre référence, non ?<br />
<br />
Tout à fait, en fait le billet était déjà corrigé mais le flux RSS était déjà parti un peu partout, merci de l'avoir signalé ;-).<br />
<br />
Concernant le snippet il était dans mes favoris mais je l'avais complètement oublié ! Je vais voir ce que je peux faire avec. Il faudra que j'intègre wiki2xhtml aussi...</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Soso</span> le <span class="comment-date" property="schema:commentTime">25/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Quand même, ça a l'air compliqué...<br />
Merci en tout cas pour m'avoir &quot;tuyauté&quot; via ton exemple à l'utilité d'un sitemap pour mon blog. J'ai effectivement trouvé des générateurs de sitemap pour wordpress, je vais aller voir si ça existe pour Dotclear...<br />
<br />
Bon courage !</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">25/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Il y a le plugin gsitemap pour dotclear disponible ici : <a href="http://callmepep.org/bricoland/" title="http://callmepep.org/bricoland/" rel="nofollow">callmepep.org/bricoland/</a><br />
<br />
Merci pour les encouragements :-).</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">zyegfryed</span> le <span class="comment-date" property="schema:commentTime">25/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Concernant les commentaires, James Bennett (<a href="http://www.b-list.org/" title="http://www.b-list.org/" rel="nofollow">www.b-list.org/</a>) vient de sortir une application de modération &quot;bien propre&quot; (comparée aux hacks qu'il donnait il y a un an, d'après l'auteur) : comment_utils (<a href="http://code.google.com/p/django-comment-utils/" title="http://code.google.com/p/django-comment-utils/" rel="nofollow">code.google.com/p/django-...</a>)<br />
Ce pourrait être un petit plus pour la gestion des commentaires (surtout niveau modération du spam, etc.)...<br />
Bye :)<br />
Seb</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David</span> le <span class="comment-date" property="schema:commentTime">27/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Django-fr launched this past week. The site’s creator, David Larlet, posted the announcement to django-users: “The aim of this site is to provide translations of the documentation, useful links and of course to create a local community!” The site is still evolving as more users are becoming aware of it and contributing translations that will go through an approval process. The Django-fr group also coordinates their efforts on their Django-fr mailing list and on #django-fr on irc.freenode.net.<br />
<br />
<a href="http://www.djangoproject.com/weblog/2007/jun/26/djangostatusupdate/" title="http://www.djangoproject.com/weblog/2007/jun/26/djangostatusupdate/" rel="nofollow">www.djangoproject.com/web...</a><br />
<br />
Le début de la gloire ? ;-)<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">27/06/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>@zyegfryed : oui j'ai vu, merci pour le lien. En fait c'est en train d'être réécrit si j'en crois Jacob <a href="http://groups.google.com/group/django-developers/browse_thread/thread/f03591808a8b12f5/836e8a2b0ae37fa5#836e8a2b0ae37fa5" title="http://groups.google.com/group/django-developers/browse_thread/thread/f03591808a8b12f5/836e8a2b0ae37fa5#836e8a2b0ae37fa5" rel="nofollow">groups.google.com/group/d...</a><br />
<br />
Donc j'attends encore un peu mais en terme d'anti-spam c'est intéressant en effet.<br />
<br />
@David : la gloire, la gloire, appelons ça plutôt la reconnaissance d'une équipe motivée :-).</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">NiCoS</span> le <span class="comment-date" property="schema:commentTime">09/07/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Merci pour cet article nickel et qui me servira un jour pour Atome :-P<br />
<br />
Plus je vois les contrib qui sortent pour Django, plus ça me pousse à retarder le dev d'Atome parfois :-D<br />
<br />
On va déjà finaliser et déployer la version 0.1 de MvMo et on verra bien ensuite dans quoi je vais me lancer (ou pas).<br />
<br />
++</p>
    </div>
</div>

    </div>
  </section>

    
    <footer>
      <nav>
        <p>
          <small>
            Je réponds quasiment toujours aux <a href="m&#x61;ilto:d&#x61;vid%40l&#x61;rlet&#46;fr" title="Envoyer un email">emails</a> (<a href="/david/signature/" title="Ma signature actuelle avec possibilité de chiffrement">signés</a>) et vous pouvez me rencontrer à Montréal. <span class="more-infos">N’hésitez pas à <a href="/david/log/" title="Être tenu informé des mises à jour">vous abonner</a> pour être tenu informé des publications récentes.</span>
          </small>
        </p>
      </nav>
    </footer>
    
  </div>
  
  <script src="/static/david/js/larlet-david-3ee43f.js" data-no-instant></script>
  
  <script data-no-instant>InstantClick.init()</script>
  
</body>
</html>