Skip to content

Commit

Permalink
Clean up WordPress import documentation a little
Browse files Browse the repository at this point in the history 
Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
@Kwpolska
Kwpolska committed Jul 17, 2015
1 parent e72340a commit b62e365
Showing 1 changed file with 10 additions and 9 deletions.
19 changes: 10 additions & 9 deletions stories/manual.txt
View file
Expand Up @@ -1771,26 +1771,27 @@ the appropriate path if this happens.
We recommend using stories with dates in the past (1970-01-01) to avoid We recommend using stories with dates in the past (1970-01-01) to avoid
dependency issues. dependency issues.


Importing Your WordPress Site Into Nikola Importing your WordPress site into Nikola
----------------------------------------- -----------------------------------------


If you like Nikola, and want to start using it, but you have a WordPress blog, Nikola If you like Nikola, and want to start using it, but you have a WordPress blog, Nikola
supports importing it. Here's the steps to do it: supports importing it. Here are the steps to do it:


1) Get a XML dump of your site [#]_ 1. Get an XML dump of your site [#]_
2) nikola import_wordpress mysite.wordpress.2012-12-20.xml 2. ``nikola import_wordpress mysite.wordpress.2012-12-20.xml``


After some time, this will create a ``new_site`` folder with all your data. It currently supports After some time, this will create a ``new_site`` folder with all your data. It currently supports
the following: the following:


* All your posts and pages * All your posts and pages
* Keeps "draft" status * Keeps “draft” status
* Your tags and categories * Your tags and categories
* Imports your attachments and fixes links to point to the right places * Imports your attachments and fixes links to point to the right places
* Will try to add redirects that send the old post URLs to the new ones * Will try to add redirects that send the old post URLs to the new ones
* Will give you a url_map so you know where each old post was * Will give you a URL map so you know where each old post was


This is also useful for DISQUS thread migration! This is also useful for DISQUS thread migration, or server-based 301
redirects!


* Allows you to export your comments with each post * Allows you to export your comments with each post
* Exports information on attachments per post * Exports information on attachments per post
Expand Down Expand Up @@ -1842,15 +1843,15 @@ about it.


Other versions may or may not work. Other versions may or may not work.


Importing To A Custom Location Or Into An Existing Site Importing to a custom location or into an existing site
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


It is possible to either import into a location you desire or into an already existing Nikola site. It is possible to either import into a location you desire or into an already existing Nikola site.
To do so you can specify a location after the dump: To do so you can specify a location after the dump:


.. code:: console .. code:: console


$ nikola import_wordpress mysite.wordpress.2012-12-20.xml -o import_location $ nikola import_wordpress mysite.wordpress.2012-12-20.xml -o import_location


With this command Nikola will import into the folder ``import_location``. With this command Nikola will import into the folder ``import_location``.


Expand Down

0 comments on commit b62e365

Please sign in to comment.