Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Follow these steps to add a quick start file to Web Viewer.

  1. Create an html file for the quick start guide. The file will need to follow the sample format below.

    1. Each <div id="div1" class="container"> will become one page in the quick tip guide.

    2. Images can be used in the html file, but they will need to be referred using a specific syntax as described below and placed in a sub folder called Documents/Content.

  2. Create a new document in Manager.

    1. Add the quick start document to the document in Manager. Add all the translations needed.

...

    1. Image Added
  1. Set meta data on the document in Manager.

    1. Set Label="quicktips" or Identity="quicktips".

    2. Name that allow search, e.g. "Quick tips"

    3. Add specifications that are searchable but not visible to make the document searchable. E.g. add "Help" as a specification.

    4. Ensure to set mode as "IncludeInPublish" to ensure the document is included at publish despite not being added to a catalogue.

  2. Manually copy images used in the html to the site. The images shall be placed in this folder <site>/Documents/Content/ on the editor server.

  3. Update profile.config to enable quick start guide

Code Block
     <QuickStartGuideEnabled>true</QuickStartGuideEnabled>
     <QuickStartGuideNextPreviousButtonEnabled>true</QuickStartGuideNextPreviousButtonEnabled>
     <QuickStartGuideDocument identity="quicktips"/>     or     <QuickStartGuideDocument label="quicktips"/>

...

It is also possible to add a pdf-based quick start guide. If this is the case, follow this procedure.

  1. Add the document to Manager and set metadata according to step 2 and 3 above.

  2. Update the profile.config according to step 5 above, but omitt the QuickStartGuideNextPreviousButtonEnabled tag since it cannot be used in a pdf.

Changing an existing quick start guide

Follow these steps:

  1. Changing an existing quick start guide by finding the existing quick start guide in document storage. Typically filter the storage on “quick”. Ensure to allow search on label, identity and persistent identity.

  2. Select to upload a new version of the file by clicking the file select icon.

    Image Modified

...

  1. Publish the changes.

If you wish to get the original file and make changes to it, the file has to be retrieved from the server. The file is located in the site folder’s sub folder for documents. Each language version is located in a language sub folder. Typically this is at:

...

Filter by label (Content by label)
showLabelsfalse
max5
spacesASKB
showSpacefalse
sortmodified
showSpacetypefalsepage
reversetrue
typelabelspageQuick Help Tips
cqllabel in ( "help" , "quick" , "tips" ) and type = "page" and space = "ASKB"labelsQuick Help Tips
Page Properties
hiddentrue


Related issues