Documentation Dotclear 2.6:admin:migrate

2.6:admin:migrate:blog.free.fr

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Migrer d'un blog hébergé par Free vers Dotclear 2 ======

	+	Voici comment migrer d'un blog hébergé sur [[http://blog.free.fr/\|la plateforme de blogs de Free.fr]] vers un blog Dotclear 2.
	+
	+	Après avoir utilisé le service blog.free pour des raisons de commodité et de rapidité d'installation, nous souhaitions en sortir et être autonomes : travailler à plusieurs administrateurs avec chacun son mot de passe, ouvrir à des rédacteurs avec des permissions réduites; utiliser d'autres widgets, améliorer la configuration etc., enfin utiliser tout Dotclear sans être bridé. Nous voulions aussi rester chez le même hébergeur.
	+
	+	Mais comment passer d'un blog.free(DC2) vers un DC2 toujours sur free ?
	+	Le problème est qu'il s'agit à la fois d'une migration et d'une installation nouvelle; un hybride, __une migrinstall__.
	+	----
	+	----
	+
	+	===== A- L'installation d'un Dotclear sur son serveur =====
	+
	+	En préliminaire : une fois faite l'installation classique de dotclear2 sur le serveur de free (en automatique), il faudra suivre la procédure "d'installation propre" proposée par la documentation pour mettre un fichier /blog à la racine dans lequel on aura créé les fichiers themes, public et plugins.
	+	http://fr.dotclear.org/documentation/2.0/admin/clean-install
	+
	+	__Cette installation "propre" impliquera la redirection des images et des billets de dotclear2 /public vers blog/public,__ celle-ci ne pouvant se faire en automatique.
	+
	+
	+	===== B- La migration par étapes de blog.free vers DC2 =====
	+
	+	==== 1- sauvegarde des documents du blog.free ====
	+	* sauvegarde des billets
	+
	+	Dans le blog.free passer par "Import/export" puis "Exporter un fichier texte" puis "Exporter un blog".
	+	On obtient une sauvegarde des billets sur son disque dur. Elle porte la date de sauvegarde, le nom du blog et se termine par -backup.txt
	+
	+	* sauvegarde des images
	+
	+	Dans blog.free passer cette fois dans "Gestionnaire de médias".
	+	- on peut essayer de "télécharger ce répertoire" d'images s'il n'est pas trop lourd et si la connexion est rapide;
	+	- sinon télécharger fichier par fichier.
	+	On récupère ainsi un (ou des) fichier(s) zip sur son disque dur.
	+
	+	==== 2- redirection des images du dossier public de DC2 vers le nouveau dossier /blog/public ====
	+	* création du code de redirection.
	+
	+	Pour rediriger les images vers /blog/public on crée un fichier texte dans un éditeur de texte contenant le code :
	+	''RedirectPermanent /public/ http://nomdusite.free.fr/blog/public/''
	+
	+	Pour free il y a déjà un fichier .htaccess sur le serveur, comportant la mention "php1". Il suffira d'intégrer ce texte à notre nouveau code.
	+
	+	''php1''
	+
	+	''RedirectPermanent /public/ http://nomdusite.free.fr/blog/public/''
	+
	+	Ce fichier sera enregistré sous le nom : htaccess (avec ou sans extension).
	+
	+	* renommage du fichier htaccess
	+
	+	On indiquera si besoin dans les Préférences du logiciel de téléchargement : "afficher les fichiers cachés" ainsi que la fonction d'encodage UTF8.
	+	Par ftp on dépose le fichier htaccess à la racine du site, à côté des deux dossiers (dotclear et blog.)
	+
	+	En surlignant le nom du fichier puis en tapant sur la touche "entrée" de son clavier, on renomme ce fichier : .htaccess (point htaccess).
	+
	+	==== 3- importation dans le nouveau DC2 ====
	+
	+	* Import des billets
	+
	+	--> On dépose le fichier sauvegardé backup.txt (du blog.free) dans le dossier blog/public par ftp. On prendra soin de vérifier que le mode de transfert par défaut du logiciel de ftp soit "automatique". Sinon pour les fichiers zip il doit être Binaire; il doit être ASCII pour les txt.
	+
	+	Via Import/Export sur DC2 on fait "importer depuis un fichier texte" et "Importer un blog" en le choisissant dans le fichier local du répertoire public.
	+	Les billets sont installés.
	+
	+	--> A noter que si pour une raison quelconque on souhaite supprimer ce backup.txt et le remplacer par un plus récent, il faudra penser, après l'avoir supprimé par ftp, à supprimer les catégories, sans cela l'import des billets ne sera pas possible. La suppression des catégories se fera par le [[http://mudry.org/blog/post/2007/08/05/Greffon-bigRedButton-version-02\|plugin bigRedButton]] à installer sur le DC2.
	+
	+	* Import des images
	+
	+	Les fichiers zippés de plus de 2MB sont déposés par ftp dans le /blog/public.
	+	En passant par le Gestionnaire de médias, les fichiers sont dézippés avec la demande de les créer dans "un nouveau répertoire" : cela donnera un nouveau dossier du même nom.
	+	Les images devraient se trouver automatiquement associées aux billets.
	+
	+	===== C- Le DC2 nouveau : derniers boulons =====
	+
	+	=== 1- paramétrages ===
	+	Les noms ainsi que d'autres éléments des widgets, leur ordre, les indications qu'on avait paramétrées, ne sont pas toujours récupérés. Il faut donc les refaire...
	+
	+	Si l'installation ne se passe pas au mieux (coupures de transferts de zips générant des fichiers doublés, miniatures impossibles, images invisibles etc.), plutôt que de bricoler, préférer reprendre tout à zéro suivant la formule bien connue : "Si tout va mal, réinstalle".
	+
	+	=== 2- feu blog ===
	+
	+	A fin avril 2009, free ne fournit encore pas de documentation pour supprimer le blog.free; trop jeune sans doute pour cela. Il faut attendre.
	+	* De ce fait, il faudra d'abord sur son blog.free faire un billet indiquant la redirection vers le nouveau blog; mettre l'ensemble des billets hors ligne et modifier la première page en supprimant ce qui n'est plus nécessaire à l'affichage.
	+	* Ensuite prévenir les sites sur lesquels on est référencé pour qu'ils changent notre adèl.
	+
	+	Donc c'est avec un peu de patience que le nouveau blog dotclear2 peut fonctionner.
	+	Mais un soulagement : on a bien quitté le cocoon fermé du blog.free et maintenant c'est la vraie liberté.
	+
	+	----
	+	----
	+
	+	Merci à toute l'équipe de Dotclear pour leur sacré boulot et leurs conseils, au modo de la DreamteamDC2, au modo à carapace et au responsable du photocopieur, merci au forum en général qui a aidé à ce mémo.
	+
	+	//Verveine et Martin//
	+	//pour l'équipe du Café des Vallées//

2.6:admin:migrate:rss

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Migrer vers Dotclear 2 grâce au flux RSS d'un blog ======

	+	En lisant le flux RSS d'un autre blog, Dotclear peut importer les billets de cet autre blog, et seulement les billets. Les commentaires, images, pièces jointes, liens, etc. ne seront pas copiés.
	+
	+	Dans l'administration, cliquez sur EXTENSIONS > Import/Export. Cliquez ensuite sur Importer depuis un flux.
	+
	+	Entrez l'adresse du flux du blog que vous voulez importer dans le champ URL du fil puis cliquez sur Envoyer. Les billets sont enregistrés sur votre blog Dotclear. Pour enregistrer les billets plus anciens, connectez-vous à l'administration du blog que vous voulez importer, mettez hors ligne les billets déjà importés pour que le flux du blog affiche les anciens billets. Recommencez l'opération. Ainsi les anciens billets seront aussi importés. Peu importe l'ordre dans lequel les billets sont ajoutés, Dotclear récupère la date du billet.

2.6:admin:migrate:wordpress

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Migrer de WordPress à Dotclear 2 ======

	+	===== Introduction =====
	+
	+	Dotclear est différent de WordPress mais il offre des facilités à ceux qui veulent migrer depuis WordPress.
	+
	+	* l'import des filtres de WordPress
	+	* des URLs personnalisables
	+
	+	<note important>
	+	Ceci effacera les catégories, liens, billets et commentaires du blog sur lequel vous êtes connecté. Vous pouvez créer un nouveau blog et vous y connecter si vous voulez garder ce contenu.
	+	</note>
	+	===== Migration =====
	+
	+	Pour commencer, connectez-vous à l'interface d'administration de Dotclear, cliquez sur EXTENSIONS > Import/Export puis cliquez sur Importer depuis Wordpress. Remplacez les 5 champs pour identifier la base de données MySQL utilisée par WordPress (ces informations se trouvent dans le fichier ''wp-config.php'' de WordPress).
	+
	+	Par défaut, la première catégorie de WordPress est "Uncategorized", et chaque billet est dedans. Dans Dotclear, les catégories sont facultatives, c'est pourquoi l'importeur propose une option pour ignorer la première catégorie de WordPress.
	+
	+	Par sa conception, Dotclear n'autorise qu'une catégorie par billet, alors que WordPress n'offre pas de limite. Les options "Importer les catégories comme des tags :" et "Préfixer ces tags avec : " permettent de compenser ça en migrant les catégories vers les tags.
	+
	+	FIXME WordPress can apply multiple formatters to each post, but Dotclear only uses one per post, so if you use something non-standard such as [[http://lab.dotclear.org/wiki/plugin/formatting-markdown\|Markdown]], you might need to specify that in the "Content filters" pop-ups (if you used a mix of formats, you might need to fix the ones which don't match the pop-up). Additionally, you might want to set the preferred formatter for yourself and any other users who write in formats other than Dotclear's default wiki syntax.
	+
	+	Une fois que votre contenu est importé, vous pourriez avoir besoin de changer le shéma par défaut des URLs pour le faire correspondre à celui de WordPress. Il est configurable dans Extensions > about:config, c'est le paramètre ''post_url_format''.
	+
	+	Les utilisateurs sont importés, mais le mot de passe de chaque utilisateur a été modifié, ils devront utiliser le formulaire de demande d'un nouveau mot de passe pour recevoir un nouveau mot de passe.
	+
	+	L'import comprend les billets, commentaires, utilisateurs, catégories et liens. Il n'inclue pas les thèmes ou les extensions mais certains thèmes sont disponibles pour Dotclear et WordPress. Les URLs de notifications ("pingers") et les brouillons des billets ne sont pas importés.
	+
	+	Les clés de l'Antispam Akismet doivent être entrées manuellement dans l'extension Akismet de Dotclear. Après l'installation il est disponible dans le menu Extensions > Antispam.
	+	===== Les trucs en plus à garder à l'esprit : =====
	+
	+	* Dotclear n'accepte qu'une catégorie par billet
	+	* Dotclear peut importer des données depuis une base MySQL avec WordPress, mais pas depuis un export XML de WordPress (WXR) ou d'un export MySQL. Pour résoudre ce problème, vous pouvez installer temporairement une base MySQL sur le même serveur que Dotclear et y copier la base de données de WordPress afin de l'importer dans Dotclear.
	+	* Dotclear exige un préfixe ''post/'' à l'URL pour les billets (en mode PATH_INFO). Ce n'est pas le cas pour WordPress. Vous devriez pouvoir trouver une solution avec l'[[http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html\|URL rewriting]], des redirects spécifiques pour les préfixes de dossier de base de Wordpress (dans mon cas, les années) pour rediriger vers les URL Dotclear avec l'insertion du préfixe ''post/''. Par exemple, dans Apache ''httpd'' :
	+
	+	<code>RedirectPermanent /2008 http://dotclear.org/post/2008</code>