This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant previous version.

Importing Pages from Disk

Added by Vidya Madabushi, last edited by Edwin Dawson [Atlassian] on May 18, 2008  (view change) show comment
Confluence 2.8 Documentation

Index

Confluence allows you to import text files from a disk or a directory on the Confluence server, and convert them into corresponding Confluence pages. Each file will be imported as a Confluence page with the same name as the file.

The text file needs to contain Confluence markup to be converted accurately into a Confluence page.

You need to be a space administrator to import text files.

To import text files,

  1. Go to the 'Space Admin' tab of the Browse Space view. To do this:

    • Go to a page in the space, open the 'Space' menu and select 'Space Admin'. The 'Space Administration' view will open.

    'Space Admin' is only displayed if you are a space administrator.


  2. Click on the 'Import pages from disk' link in the left panel under the heading 'Import'. This will display a new screen.

  3. Type in the directory's path in the 'Import directory' text field.

  4. Check 'Trim file extensions' to remove file extensions when converting the files to Confluence pages. Note that the Confluence pages will take their titles from the files' names (including their extensions). So to avoid having page titles with the suffix 'txt' in them, make sure you check this box.

  5. Check 'Overwrite existing pages' if you want to replace existing Confluence pages with the same page title.

  6. Click 'Import'.



Screenshot : Importing text files

The ability to import pages from disk applies only to global spaces, so the 'Import' section in the above screenshot does not appear in the 'Space Admin' tab for personal spaces. Please see Working with Spaces Overview for information about the differences between global spaces and personal spaces.


RELATED TOPICS

Take me back to Confluence User Guide

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

Comments (12)

 

  1. Oct 20, 2006

    John Pettersson says:

    What kind of encoding shall the filename and the text have? I am about to import...

    What kind of encoding shall the filename and the text have? I am about to import som swedish texts (å, ä, ö, Å, Ä, Ö)

     /John, Sweden

    1. Oct 23, 2006

      Matt Ryall says:

      Currently, this method uses the default system encoding of Java, which is determ...

      Currently, this method uses the default system encoding of Java, which is determined automatically from your system. This means it should work with whatever encoding is native for files on your operating system.

      I'd suggest importing one or two files first as a test, and if there is a problem with the encoding, let us know and we can add a configuration option to Confluence to change it.

    2. Oct 30, 2006

      Matt Ryall says:

      There is now a JIRA issue for this enhancement CONF7235@JIRA, with two possible ...

      There is now a JIRA issue for this enhancement, with two possible workarounds.

  2. Jan 03, 2007

    Dale Tan says:

    Hi there, I'm wondering whether space admins could markup the text to include la...

    Hi there, I'm wondering whether space admins could markup the text to include labels and hierachial data as well? It's a really nifty import plugin if you've got a small number of pages, but I've got a heap and I'm wondering how they can go in labelled and all.

    1. May 29

      Jonathan Reed says:

      We use the macro to include labels in the markup. It works, as long as you ...

      We use the

      {add-label:labename-goes-here}

      macro to include labels in the markup. It works, as long as you adhere to the valid characters in labels.

  3. Jan 19, 2007

    Rick Shaw says:

    Is there a way to import attachments using this feature? How about linking child...

    Is there a way to import attachments using this feature? How about linking children pages to parent pages?

    I wish to use it for bulk loading but may of the pages will have children and attachments. 

  4. Feb 08, 2007

    Tom Woodington says:

    Is there any was I can schedule an import to run on a regular schedule?...

    Is there any was I can schedule an import to run on a regular schedule?

    Basically I've got a perl script I wrote to exports information from an oracle database to html files that are searched with a seperate indexing system but I would like to index these in a seperate confluence space. Modifying the script to give wiki markup would be trivial but getting it in to confluence seems not so simple. (I'm looking at tens of thousands of imports initially and regular imports of up to 100 a day)

  5. Feb 08, 2007

    Mark Fletcher says:

    Is there a way to influence where in the space hierarchy the pages will be impor...

    Is there a way to influence where in the space hierarchy the pages will be imported? Or will they always come in as children of the home page?

     Also, is there a way to enforce Edit restrictions in the Wiki markup? My pages will contain {html:script} tags to external content and shouldn't be editable by most users.

  6. Jul 31, 2007

    Jennifer Schuck says:

    Is there a way to import the text files under a specified space hierarchy? ...

    Is there a way to import the text files under a specified space hierarchy?  I would like for my imported text files to be imported under the home page of the space?

    1. Aug 02, 2007

      Choy Li Tham says:

      Hi Jennifer, We would suggest you to import the page from disk

      Hi Jennifer,

      We would suggest you to import the page from disk, then move the imported page from one space to another space as mentioned in the following document:

      You may also give a try to snip snap import and see how it goes.
      Hope the informations might be of help.

  7. May 29

    Jonathan Reed says:

    I'd like to share two "gotchas" that we learned the hard way: \\ \ If you are im...

    I'd like to share two "gotchas" that we learned the hard way:

    * If you are importing a LOT of pages (1972 was the smallest batch, 4305 was the largest), the import process will begin, and then time out with an HTTP 503 error. If you then go back to your Confluence installation (do NOT reload the page that timed out), you'll see that the import process is still ongoing (thanks to the magic of threads, presumably). Unfortunately, the only way to know when it's done is to watch the page count in the space you're importing into (which used to be viewable in the Alphabetic page listing, but not anymore) and see when it stops incrementing. It's unfortunate that Confluence doesn't simply use DHTML to periodically reload the Import page and inform you of the progress.  See CONF-11979

    * If any of the pages you import contain invalid characters in their filename (which will become the title), Confluence will throw an InfrastructureException, and you'll have to dig through the log full of 113 line tracebacks to discover that it was because of an invalid page title. It's unfortunate that this error case is not handled, but for simplicitly, it may be easiest to strip out undesirable characters in the filenames - basically anything not in [A-Za-z0-9 _-]

  8. Jul 07

    Anonymous says:

    Is it possible to disable this feature? As far as I can tell, this allows any sp...

    Is it possible to disable this feature? As far as I can tell, this allows any space administrator to read any file on the server. I was able to read the contents of /etc/passwd and other sensitive files by importing them as pages. It seems like a bit of a security problem.

Add Comment