Statique par défaut

Comment publier un site MkDocs

MkDocs transforme un dossier de fichiers Markdown en site de documentation terminé. Le dossier de sortie s’appelle site, et c’est le détail sur lequel on se trompe.

Commande de build
mkdocs build
Dossier à importer
site

Offre gratuite, SSL offert, sans carte bancaire.

.droply.id
  1. Lancez le build du projet

    Lancez mkdocs build dans le dossier du projet. C’est l’étape que Droply ne fait pas à votre place : nous publions des pages finies, nous n’exécutons jamais votre build.

  2. Repérez le dossier de sortie

    Le build écrit le site final dans site. C’est ce dossier, et non celui du projet, qu’il faut importer.

  3. Faites-le glisser

    Déposez le dossier (ou un ZIP de ce dossier) dans Droply. En quelques secondes, il est en ligne en HTTPS sur un sous-domaine de droply.id, et chaque nouvel import publie une nouvelle version à la même URL.

Bon à savoir sur MkDocs

  • Le dossier à importer est site, pas docs. docs contient vos sources Markdown : l’importer publierait vos sources, pas votre site.

  • site_dir dans mkdocs.yml change le dossier de sortie. Vérifiez-le avant de supposer la valeur par défaut.

  • Réglez site_url sur l’adresse où le site sera publié. L’index de recherche et les balises canonical de Material for MkDocs s’en servent tous les deux.

  • Utilisez mkdocs build, pas mkdocs gh-deploy. Cette seconde commande fait un commit sur une branche gh-pages, ce qui est une tout autre destination.

Ce projet a été créé par un outil d’IA ?

Héberger un site généré par IA répond à la question qui précède la commande de build : avez-vous entre les mains un fichier unique ou un projet, et lequel des deux chaque outil vous fournit-il réellement ?

Questions fréquentes

Est-ce que Droply lance le build de mon projet MkDocs ?
Non, et ce ne sera jamais le cas. Droply publie des fichiers statiques finis. Exécuter votre build reviendrait à exécuter vos dépendances sur nos serveurs, ce qui est un tout autre produit, bien plus risqué. Lancez le build sur votre ordinateur ou dans votre CI habituelle, puis importez le résultat.
Quel dossier dois-je importer ?
Le dossier site créé par mkdocs build, et non le dossier du projet. Importez-le tel quel ou compressez-le d’abord en ZIP : les deux fonctionnent.
Que se passe-t-il quand je mets le site à jour ?
Relancez le build et importez de nouveau le dossier. La nouvelle version remplace l’ancienne à la même URL : un lien déjà partagé continue donc de fonctionner. Les offres Pro, Business et Enterprise conservent un historique des versions : vous revenez à n’importe laquelle en un clic.
Puis-je utiliser mon propre nom de domaine ?
Oui, avec les offres Pro, Business et Enterprise. Faites pointer votre domaine vers Droply : le certificat est émis et renouvelé automatiquement.