davidbgk
/
larlet-fr-david

<!doctype html>
<html lang=fr>
<head>
  <!-- Always define the charset before the title -->
  <meta charset=utf-8>
  <title>Initialisation et modèles de données de la refonte — 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/20070412-initialisation-et-modeles-de-donnees-de-la-refonte">

</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">Initialisation et modèles de données de la refonte</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 a pris un peu de retard. Aujourd'hui on va de l'initialisation de l'environnement de développement au modèle de données retenu. Je pars vraiment de la base pour que vous puissiez réellement suivre la refonte si vous êtes intéressé(e). C'est d'ailleurs la raison pour laquelle j'ai mis le code sur un dépôt public (cf. fin du billet).</p>

<h2>Initialisation</h2>

<p>Commençons par installer django, j'ai décidé de mettre les sources dans <strong>~/web/</strong> car j'avais l'habitude d'avoir la dernière version à jour et c'est quand même plus pratique d'être dans sa home pour faire un svn up. Depuis la sortie de la 0.96, la version du dépôt officiel n'est plus aussi stable qu'avant (comme il était prévu), nous allons donc installer la version 0.96 pour la refonte&nbsp;:</p>

<pre>$ cd &amp; cd web
$ wget http://www.djangoproject.com/download/0.96/tarball/
$ tar xvf Django-0.96.tar.gz &amp;&amp; rm Django-0.96.tar.gz
$ sudo ln -sf /home/david/web/Django-0.96/django /usr/lib/python2.5/site-packages/</pre>

<p>À adapter bien entendu à votre configuration (python 2.5 par défaut avec Feisty \o/). Normalement la commande <strong>ls -l /usr/lib/python2.5/site-packages/dj*</strong> devrait vous renvoyer&nbsp;:</p>

<pre>lrwxrwxrwx 1 root root 34 2007-04-02 08:32 /usr/lib/python2.5/site-packages/django -&gt; /home/david/web/Django-0.96/django</pre>

<p>Vous pouvez aussi vérifier en faisant un <strong>python -c "import django;print django.VERSION"</strong> qui ne devrait pas lever d'erreur et renvoyer <strong>(0, 96, None)</strong>. <em>Si vous récupérez directement les sources du projet, les étapes d'initialisation suivantes sont inutiles.</em></p>

<p>Ok, tout marche bien, créons donc notre projet de refonte (par commodité, je me mets dans le dossier refonte)&nbsp;:</p>

<pre>$ mkdir refonte &amp;&amp; cd refonte
$ /usr/lib/python2.5/site-packages/django/bin/django-admin.py startproject biologeek
$ cd biologeek/</pre>

<p>Vous pouvez aussi mettre le répertoire <strong>bin</strong> de <strong>django</strong> dans votre <strong>$PATH</strong> pour ne pas avoir à aller le récupérer dans les paquets python mais comme je ne m'en sers que pour la création de projets je trouve ça un peu inutile.</p>

<p>Il ne reste plus qu'à paramétrer tout ça en modifiant le fichier <strong>settings.py</strong> et vous pourrez alors synchroniser la base pour la première fois&nbsp;:</p>

<pre>$ python manage.py syncdb</pre>

<p>La création d'un super-utilisateur est demandée, une fois cet utilisateur créé, vous pouvez lancer votre serveur de développement pour la première fois&nbsp;:</p>

<pre>$ python manage.py runserver</pre>

<p>En vous rendant sur http://127.0.0.1:8000/ vous aurez le message de bienvenue et sur /admin/ vous pourrez accéder à votre interface d'administration (en décommentant la ligne dans urls.py).</p>

<p>On va maintenant créer les deux «&nbsp;applications » de la refonte&nbsp;: <strong>journal</strong> et <strong>bistrot</strong>.</p>

<pre>$ python manage.py startapp journal
$ python manage.py startapp bistrot</pre>

<p>Je m'arrête là pour l'initiation à Django, ces bases là suffisent pour comprendre ce qui va suivre, si vous voulez en savoir plus <a href="https://larlet.fr/david/biologeek/archives/20060617-traduction-francaise-de-la-documentation-de-django-le-framework-web-python/">rien ne vaut un bon tutoriel</a>.</p>

<h2>Modèles de données</h2>

<p>Le modèle de données doit être placé dans les fichiers <strong>models.py</strong> situés dans les répertoires des deux applications créées. Le journal va contenir des billets qui auront le modèle suivant&nbsp;:</p>

<pre>class Post(models.Model):
    title = models.CharField('Titre', maxlength=200)
    slug = models.SlugField('Adresse', prepopulate_from=('title',), primary_key='True')
    tags = models.ManyToManyField(Tag, help_text='Sélectionnez les tags.')

    summary = models.TextField('Description', help_text='Différentes syntaxes possibles (cf. markup)', blank=True)
    summary_html = models.TextField('Description HTML', blank=True)
    content = models.TextField('Contenu', help_text='Difféntes syntaxes possibles (cf. markup)')
    content_html = models.TextField('Contenu HTML', blank=True)

    related_posts = models.ManyToManyField('self', help_text='Sélectionnez les billets en relation.', blank=True)
    related = models.TextField('Contenu additionnel', help_text='Difféntes syntaxes possibles (cf. markup)', blank=True)
    related_html = models.TextField('Contenu additionnel HTML', blank=True)

    creation_date = models.DateTimeField('Date de création')
    modification_date = models.DateTimeField('Date de modification')
    publication_date = models.DateTimeField('Date de publication', null=True, blank=True)

    image = models.ImageField('Image associée', upload_to='%s/media/logos/' % settings.PROJECT_PATH, blank=True)
    is_draft = models.BooleanField('Brouillon', default=True)
    is_bestof = models.BooleanField('Best of', default=False)
    markup = models.CharField(maxlength=20, choices=MARKUP_CHOICES, radio_admin=True, default='markdown')</pre>

<p>Je ne vais pas détailler, les champs parlent d'eux-même. Par contre, il est intéressant de commenter le manager que j'ai associé&nbsp;:</p>

<pre>class PostManager(models.Manager):
    def get_query_set(self):
        """ Retrieve only published posts. """
        qs = super(PostManager, self).get_query_set()
        return qs.filter(is_draft=False)

    def get_best_of(self):
        """ Retrieve only best of published posts. """
        qs = super(PostManager, self).get_query_set()
        return qs.filter(is_bestof=True)</pre>

<p>Un manager permet d'accéder facilement à un catégorie de billets, il faut pour cela ajouter à votre classe Post par exemple&nbsp;:</p>

<pre>class Post(models.Model):
    [...]
    objects = models.Manager()
    published = PostManager()</pre>

<p>Et la récupération des données est simplifiée ainsi&nbsp;:</p>

<ul>
<li><strong>Post.objects.all()</strong> pour l'ensemble des données&nbsp;;</li>
<li><strong>Post.published.all()</strong> pour l'ensemble des données publiées&nbsp;;</li>
<li><strong>Post.published.get_best_of()</strong> pour l'ensemble des données publiées et sélectionnées.</li>
</ul>

<p>On peut faire beaucoup de choses avec les managers et c'est relativement pratique pour ne pas se tromper lorsque l'on doit continuellement filtrer des données à accès restreint.</p>

<p>Pour les brèves du bistrot, le code est assez similaire&nbsp;:</p>

<pre>class Thought(models.Model):
    title = models.CharField('Titre', maxlength=200)
    slug = models.SlugField('Adresse', prepopulate_from=('title',))
    tags = models.ManyToManyField(Tag, help_text='Sélectionnez les tags.')

    content = models.TextField('Contenu', help_text='Vous pouvez utiliser markdown')
    content_html = models.TextField('Contenu HTML', blank=True)

    creation_date = models.DateTimeField('Date de création')
    modification_date = models.DateTimeField('Date de modification')
    publication_date = models.DateTimeField('Date de publication', null=True, blank=True)</pre>

<p>Il y a juste le manager dans lequel je suis en train d'intégrer les votes donc j'en parlerais probablement plus tard, je vais m'arrêter là sinon je publierais jamais ce billet :-).</p>

<h2>Accès au code source</h2>

<p>J'ai créé pour l'occasion un <a href="http://code.google.com/p/biologeek/">projet sur Google Code qui contient l'intégralité du code</a>. Vous pouvez facilement récupérer le code avec subversion&nbsp;:</p>

<pre>svn checkout http://biologeek.googlecode.com/svn/trunk/ biologeek</pre>

<p>Checkoutez, testez, participez&nbsp;!</p>
      </div>
    </article>
    <footer>
      <h6 property="schema:datePublished">— 12/04/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/20070623-ajout-des-flux-rss-du-sitemap-et-des-commentaires-avec-django/" title="Accès à Ajout des flux RSS, du sitemap et des commentaires avec Django">Ajout des flux RSS, du sitemap et des commentaires avec 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>
      </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">NiCoS</span> le <span class="comment-date" property="schema:commentTime">12/04/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Pour django-admin.py, tu peux aussi faire un simple lien symbolique :<br />
sudo ln -s /usr/lib/python2.5/site-packages/django/bin/django-admin.py /usr/local/bin/django-admin.py <br />
<br />
Sinon si tu utilises Eclipse, PyDev ne suit pas les liens symboliques, dont tu dois ajouter /home/david/web/Django-0.96/ à ton PythonPath d'eclipse. Histoire d'avoir l'autocomplétion notamment :-)<br />
<br />
A quoi te servent les champ *_html ?<br />
<br />
Sinon intéressant le coup des manager, je connaissais pas, tout comme plein de petites choses que tu as mis à droite et à gauche :-)</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">12/04/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>&gt; Pour django-admin.py, tu peux aussi faire un simple lien symbolique<br />
Tout à fait, mais bon comme je disais ça sert pas tous les jours.<br />
<br />
&gt; Sinon si tu utilises Eclipse<br />
Ma ram a généralement une meilleure utilité ;-).<br />
<br />
&gt; A quoi te servent les champ *_html ?<br />
Je convertis selon le markup le contenu en html et je le stocke en base pour ne pas que la conversion soit faite à la volée à chaque chargement de page dans le template.<br />
</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">12/04/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Hmm pour les champ *_html, quel est le gain par rapport au fait d'utiliser le cache de django par ex ?</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">vincent</span> le <span class="comment-date" property="schema:commentTime">12/04/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Pour le coup des managers, quand j'en fait un (notament pour iki), je faisais une QuerySet avec à tout les coups, pour pouvoir enchainer les différents critères (vu que c'est des objets QuerySet).<br />
<br />
Et j'utilise souvent le même Manager pour objects et `published`, avec un argument pris en compte dans le __init__(). Et les propriétés peuvent être fun aussi avec les managers :P<br />
<br />
Sinon, QdB :D Je vais m'en inspiré pour shortbrain (surtout le coup des *_html)</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">cédric</span> le <span class="comment-date" property="schema:commentTime">18/06/2009</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Je mets mon commentaire ici parce que c&#39;est le seul qui fait référence au champ ImageField.</p>

<p>J&#39;ai déclaré dans une classe un champ tel que :<br />picture = ImageField(upload_to=&#39;.&#39;)</p>

<p>Quand j&#39;utilise l&#39;interface admin<br />j&#39;arrive à charger mon image et à la sauvegarder<br />dans le dossier MEDIA_ROOT</p>

<p>Quand je clique sur le lien proposé par l&#39;interface admin, j&#39;ai l&#39;impression que Django ne réutilise pas MEDIA_ROOT mais cherche dans le dossier admin des sources django, pourquoi ?</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">18/06/2009</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>@cédric : tu as pensé à spécifier le setting MEDIA_URL ?</p>

<p><a href="http://docs.djangoproject.com/en/dev/ref/settings/#media-url">http://docs.djangoproject.com/en/dev/ref/settings/#media-url</a></p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">cedric</span> le <span class="comment-date" property="schema:commentTime">19/06/2009</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>oui, justement il va chercher dans :<br />/usr/lib/python2.6/dist-packages/django/contrib/admin/media/P1060799.JPG</p>

<p>il ne tiens pas compte de MEDIA_URL :<br />MEDIA_URL = &#39;http://127.0.0.1:8000/media/&#39;</p>

<p>mais de AMIN_MEDIA_PREFIX :<br />ADMIN_MEDIA_PREFIX = &#39;/media/&#39;</p>

<p>si ADMIN_MEDIA_PREFIX = &#39;/media/toto/&#39;<br />alors il cherchera à l&#39;adresse : /usr/lib/python2.6/dist-packages/django/contrib/admin/media/toto/P1060799.JPG</p>

<p>rappel : j&#39;essaie déjà via l&#39;interface admin</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">cédric</span> le <span class="comment-date" property="schema:commentTime">19/06/2009</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>oui, justement il va chercher dans :<br />/usr/lib/python2.6/dist-packages/django/contrib/admin/media/P1060799.JPG</p>

<p>il ne tiens pas compte de MEDIA_URL :<br />MEDIA_URL = &#39;http://127.0.0.1:8000/media/&#39;</p>

<p>mais de AMIN_MEDIA_PREFIX :<br />ADMIN_MEDIA_PREFIX = &#39;/media/&#39;</p>

<p>si ADMIN_MEDIA_PREFIX = &#39;/media/toto/&#39;<br />alors il cherchera à l&#39;adresse : /usr/lib/python2.6/dist-packages/django/contrib/admin/media/toto/P1060799.JPG</p>

<p>rappel : j&#39;essaie déjà via l&#39;interface admin</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">20/06/2009</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Il doit y avoir conflit entre ADMIN_MEDIA_PREFIX et MEDIA_URL.</p>

<p>Je te conseille de tester :<br />MEDIA_URL = &#39;/media/&#39;<br />ADMIN_MEDIA_PREFIX = &#39;/admin_media/&#39;</p>

<p>Et si ça marche pas de passer par la liste django francophone, ça sera plus approprié et il y a plus de monde ;)<br /><a href="http://lists.afpy.org/mailman/listinfo/django">http://lists.afpy.org/mailman/listinfo/django</a></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>