How to upload documents
The basic concept is simple:
- Navigate to the desired folder.
- If you are on the View page of the folder, click on add new item and select the appropriate item type (see below). If you can't find the item type you want in the list, click on the Contents tab, where you have two choices for adding a new item: as above, or by selecting the item type from a list (for User Guide chapters, choose File; see below) and then clicking the add new item button.
- On the Edit File page, type a name for the document (for example, "How to Upload a Document") and an optional description.
- Click the Browse button and navigate to the file and select it.
- Click Save. The upload process seems to take forever, even on a high speed connection, but it should complete within a few minutes. There is no progress indicator.
Which content type do I pick?
- User Guide chapters (ODT or PDF) use file. DO NOT USE "oodocument" as it does not work.
- Pages to be displayed on the website (like this one) use document.
- HOWTOs use wiki page.
- FAQs use faq entry.
More detailed information is available at the Plone Book and our Plone FAQs.
How to overwrite an existing document
Normally you should not do this. It's much better to upload the replacement with a different filename (see our naming conventions).
If you do want to overwrite a document:
- Go to the Contents page of the required folder (NOT the View page) and click on the name of the document. This takes you to the View page for the document.
- Click the Edit tab. This takes you to the Edit page for the document. Wait until the page stops loading; this may take awhile for a .ODT file, but is quick for .PDF.
- Click the Browse button, locate the file you want to upload, and click Open or OK or whatever your file finder dialog shows. You return to the Edit page.
- Scroll down and click Save.
Why does my OOo file look so ugly or like gibberish?
.ODT files: Plone treats them as text and displays characters that may look like gibberish in your browser.
Old .SXW files: when Plone displays an SXW file, it has to convert it to HTML first. The HTML conversion is very imperfect, and often the formatting will be poor.
In both cases, the files themselves are fine.
