/[drupal]/contributions/modules/dotclear/README.txt
ViewVC logotype

Contents of /contributions/modules/dotclear/README.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.1 - (show annotations) (download)
Wed Nov 7 23:34:55 2007 UTC (2 years ago) by aymerick
Branch: MAIN
CVS Tags: HEAD
Branch point for: DRUPAL-5
File MIME type: text/plain
Initial import of dotclear project modules
1 // $Id$
2
3 Dotclear modules
4 ================
5 http://drupal.org/project/dotclear
6
7 OVERVIEW
8 --------
9 This project contains two modules:
10 - dc_import.module - to convert your dotclear site into a drupal site
11 - dc_filter.module - to display correctly imported dotclear posts
12
13 WARNING
14 -------
15 The import module has only been tested with dotclear 1.2.3 and drupal 5.3.
16
17 DON'T BE SILLY, TEST THE IMPORT ON A TEST SERVER FIRST, NOT ON YOUR LIVE SITE. USE IT AT YOUR OWN RISK.
18
19 INSTALL / IMPORT
20 ----------------
21 1. If not already done, install and configure a new drupal site.
22 2. Place the entire dotclear modules folder into your modules directory (eg: sites/all/modules/).
23 3. Create a subdirectory 'dc' in the files directory of drupal, and copy the dotclear 'images' directory
24 into it. So you should have this directory: files/dc/images/
25 4. Go to administer -> site building -> modules, and enable the dc_filter and dc_import modules.
26 5. Go to administer -> site configuration -> input format > add input format, and create a new
27 input format called 'Dotclear' that uses the 'Dotclear' filter.
28 6. Go to administer -> site configuration -> dotclear import settings, and configure the settings.
29
30 There is no UI for launching the import, so you have to do it manually:
31 - Import users by browsing to: admin/settings/dc_import/import/users.
32 - Import categories by browsing to: admin/settings/dc_import/import/categories.
33 - Import posts by browsing to: admin/settings/dc_import/import/posts.
34
35 You can then disable the dc_import.module, and uninstall it to destroy temporary data, but do NOT disable
36 the dc_filter.module.
37
38 PATHS
39 -----
40 You can modify the .htaccess file in drupal directory to redirect old dotclear paths to new drupal paths.
41
42 Examples:
43 * For posts with format: http://yourserver/?index.php/2007/11/02/344-foo-bar
44
45 RewriteCond %{QUERY_STRING} ^([0-9]{4}/[0-9]{2}/[0-9]{2}/[0-9]+-)(.*)$
46 RewriteRule index.php/ /%2? [L,R=301]
47
48 * For posts with format: http://yourserver/index.php/2007/11/02/344-foo-bar
49
50 RedirectMatch permanent /index.php/([0-9]{4}/[0-9]{2}/[0-9]{2}/[0-9]+)-(.*)$ /$2
51
52 * For main feed:
53
54 RewriteRule ^rss.php /rss.xml [R=301,L]
55
56 TODO
57 ----
58 - Add the UI to launch the import.
59 - When fixing references to images, make the 'dc' subdirectory name configurable.
60 - Configure Dotclear input format when installing dc_filter.module.
61
62 Credits / Contacts
63 ------------------
64 Aymerick Jehanne <aymerick@jehanne.org>
65 http://aymerick.com

  ViewVC Help
Powered by ViewVC 1.1.2