| 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
|