This document describes the attachment and revision features of the KB document editor. It also includes a training exercise in which document authors attach and insert an image file into a document. For detailed information about other aspects of the document editor, please continue with this training series or return to the KB Author Training - Overview.
In previous sections of this training series we covered the Insert Image (WYSIWYG editor) and Img (HTML editor) features. Those buttons allow you to embed an image that is hosted elsewhere on the internet into your document. Please refer to KB User's Guide - Documents Tab - Insert an Image from another Website for a refresher. However, a better method of placing images or other files into your documents is to upload them onto the KB server and place them directly into your document. You can use the document editor's Attachment feature to accomplish this.
Click the link labeled Create doc [your doc number] attachment folder underneath the Body field. Note that you must have saved your document at least once in order for this link to appear. You will receive a prompt asking you whether you want to create an attachment folder. Click OK to proceed.
The image below shows that doc attachment folder for document 36725 has not yet been created.
If you or another document author already created an attachment folder, the link to the folder will read: Open doc [your doc number] attachment folder
The image below shows that the document attachment folder for doc 36725 has been created and there is one image in that folder.
Once you are ready to upload some documents to place in this document, click on the The Attachment folder Create doc [your doc number] attachment folder link, and a window will appear:
The image below shows the Attachment folder uploading window for document 36725.
To select the specific images/files to upload, click the Browse button. The multi-selection allows you to choose 500 files or more. The number of files you selected will appear in the Attachment folder uploading window, next to the Browse button.
Next, click on the Upload button in the Attachment folder uploading window. A
progress bar will appear and, very soon after, a list of the images/ files you uploaded will appear next under the Upload button. This feature is especially beneficial for those using a large
number of individual files stored in multiple folder levels. The uploader
in Firefox, Chrome and Safari uploads more files at once as well as
Unfortunately, the current KB uploader does not work in IE nor Edge, so neither will not have a multi-select feature and is still limited to 125MB files.
The image below shows that 18 files were selected via the browse button and that they were all successfully uploaded.
Click Close button to leave the Attachment folder uploading window.
The image below shows the Attachment section of the Edit screen now filled with a variety of attachment types. To add one of these attachments to your document, simply click on the Quick link or Plain link.
Your KB site may have resources such as images, banners and logos stored in a Shared attachment folder. Unlike a document-specific attachment folder, the shared attachment folder is easily accessible to all documents. The shared attachment folder functions just like a document attachment folder.
/images/groupXXX/shared/This window shows a list of files and images. You may select, delete, move, rename and delete images.
The image below shows the Shared Attachment Folder pop up window for the KB User's Guide which has a group number of 41. The arrow below points to the file path of the KB User's Guide file path.
If you wish to upload a new image to the Shared attachment folder, click the the Open shared attachment folder link.
If you wish to place an image or file from the Shared attachment folder into your document, click the Show shared attachments link.
One of the KB's most powerful features is the document Revision History. Each time you click Save change button on a document, a copy of your document as it exists at that point is stored in the KB's database as a discrete version. Even if you make and save changes subsequently, each previously saved version of the document is still present in the Revision History. This is useful not only because you can view previous versions of your document but also because it is possible to restore previous versions of a document.
You can access any version in a document's history, using the following steps:
In the document editor, click the See revisions link located to underneath the Body field and to the right of the Save change button.
You will be taken to a table that lists all of your document's versions (i.e. each point at which changes to your document were saved):
The column headings contain a specific pieces of information about the version:
To view a version you can either:
You will be taken to your selected version(s). At the bottom of each version you will see a button labeled Restore with this version. Only click this button if you wish to have that version of the document available to you in the document editor for publishing. If you just want to leave the version without restoring it, you can click the buttons for Return to revision list or Return to document editor.
Compare w/ active version
The Compare w/ active version feature functions as a side-by-side comparison. However, it only allows you to view the version of the document you're currently editing with the published version of the document. It also displays differences in the HTML code underlying each version of the document. To use this feature:
Save the below image to your hard drive by right-clicking it (if you only have one mouse button, you can CTRL+Click) and selecting Save Target As... or Save File As... (exact wording depends on your web browser). Remember where on your hard drive you saved the image.
If you are not already logged in, log into the KB Admin Tools.
Note: If your institution is not using Shibboleth, go to the Active Directory Login.
Click on the Documents tab.
Locate the document you edited in the previous exercises and open it for editing. If you are unsure how to locate the document, return to KB Author Training - Editing an Existing Document and review the instructions there.
Click the link labeled Create doc [your doc number] attachment folder. Use the Browse button to to find and select the image you saved to your hard drive.
Once you have selected the image, click the Upload to upload onto the KB server.
Click your mouse cursor in a location in your document. Then click Quick to insert the image into your doc.