KB User's Guide - General Info - Entering a Lengthy Document into the KB

We often have lengthy, 25 page plus Manuals, Handbooks, Project Charters, Protocols, Procedures, etc., that need to be accessed by users on the KB. Here are some things to consider when when breaking the document up into blocks of information.

    General Questions About Your Document

    Take moment and consider the answers to the questions below about the document that already exists in another place, that you would like to access via the KB.

    1. Is this Word Document in its very final form?
    2. Do any of the text, tables/ or diagrams need to be updated?
    3. Who is the audience for this document?
      • Is it open to the Public, will you set this set of documents to the External KB Site?
      • Will it be restricted to your Internal site? (e.g. only those who are manually entered in your Users tab will be able to access this doc)
      • Is it restricted to UW Madison or your Institution? (e.g. those who log in with a NetID) – review Campus Access Options here.
      • Is it restricted by UW Madison Department ? – review Group Authorization options here.
    4. Where are the original tables and diagrams in the Word Document kept?
    5. Do these tables and diagrams need to be updated?
    6. Do you want to assign all the docs that pertain to this Word Doc to a specific Topic? (e.g. if someone comes to your Live KB site, how will they find this info?) Follow the instructions here to Add a Topic.
    7. What kind of naming standard are you considering for this set of documents?
    8. Is there are specific logo you want to appear on each page (example: UW Crest)? If yes, create a header or add the logo to a template.
    9. Is there a specific footer on each page of the word doc? If yes, do you want it to ALSO appear in each KB doc? Please know there is a KB site footer that appears on each page.

    Table of contents

    1. Create a 1 column table as a Table of Contents.
    2. Set this document to Search Priority to High. (e.g. 3 asterisks appear in front of the title of this doc, it comes up to the top of all docs listed).
    3. You may use jquery to create a Table of Contents within a KB document.  Every header (e.g. Title in the Doc with and H3 or H4 tag) will be listed at the very top of the page so that visitors to your live site can peruse the list and go straight to the section needed instead of combing through the whole doc.

    • Here is the how-to create a jquery Table of Contents document
    • Here is an example of a jquery Table of Contents document in action

    Images

    When adding attachments to your KB Doc, the FireFox browser allows you to click on an image in the WYSIWYG Editor in the KB so that anchor buttons appear around the image (allowing you to re-size right then and there).

    Tables

    1. The table capabilities in the WYSIWYG editor are limited. A lot more can be done in the HTML editor.
    2. If the table you are pulling into the KB Doc is static, cut the table out as an image using a SnagIT, MS Paint etc., save it as an image file and upload it into your attachment folder as per usual.
    3. Should the table need to be updated over time and it is in Excel, try pulling it into http://tableizer.journalistopia.com/ and copy the HTML that it yields into the KB HTML editor.
    4. However, if the table has been created in MicroSoft Word, we would recommend that it be copied into Excel AND THEN copied into the Tableizer.
    5. It’s not always perfect…but it gets a lot of the work done.

    Text

    • The HTML Cleaner will help clean up the MS Word code.
    • Also, if you have MicroSoft Word 2016, you can save the whole doc as Save As web, filtered.
    • Use the See Also link feature (kb links appear at the bottom of the page)
    • Use the Up, Previous and Next to guide visitors to your live site.
    • Also, please consider all the keywords that are applicable to this set of docs. The Default Keywords feature will be super helpful..its easier to delete/add a couple of keywords to a long list than it is to recreate the list each time.

    Finally, please contact us at kb-team@lists.wisc.edu , we are happy to help with all questions and make mods to docs, if needed.




    Keywords:tables images HTML Cleaner excel Manuals Handbooks Project Charters Protocols Procedures Tableizer   Doc ID:55654
    Owner:Teresa A.Group:KB User's Guide
    Created:2015-08-26 13:57 CSTUpdated:2016-11-29 16:46 CST
    Sites:KB User's Guide
    Feedback:  1   0