Preparing Document Text
To prepare a document for publication on ITSM Community web site, it must first be converted to HTML. Since the ITSM Community publishing engine takes care of rendering the page according to the ITSM Community visual style, only the most basic HTML tags need be used.
Make the following replacements in the text of your publication:
Bold or strong, non-header type | <strong>Bold or strong type</strong> |
Italic or emphasized, non-header type | <em>Italic or emphasized type</em> |
Indented or quoted type | <blockquote>Indented or quoted type</blockquote> |
Title level heading | Exclude from body of document—this will be included automatically |
Top-level heading in body of document | <h2>Top-level heading in body of document</h2> |
Second-level heading in body of document | <h3>Second-level heading in body of document</h3> |
Tables | Convert tables to HTML or export as images (see below) |
Figures and other images | <img src="Image URL (see below)"/> |
Preparing Images
Ensure that the image is in a web-readable format, such as JPEG, PNG or GIF, then export the image to your hard drive if it is not already available as a stand-alone file and note its location. Follow the directions below for uploading images.
Create a new Publication
Follow these steps to create a new publication on ITSM Community.
- Go to the ITSM Community control panel (the content administrator will give you the URL to this site)
- Place your mouse over the “Publish” tab and then select the area you will be publishing to. This example assumes “Articles.”
- Enter the title of the article.
- Expand the “Summary” area and enter a brief synopsis or introduction to your publication. This text will be shown in brief listings of publications, so repeating material found in the main publication is acceptable.
- Enter the HTML created above into the “Body” area. See “Upload Images” below for information about placing images in your publication.
- If you are publishing content on behalf of another user, click on the “Options” tab, and select their name from the list of authors.
- If you wish to have your article discussed in the “Forum”, click on that tab and provide a topic title and introductory text. Make sure the “Open Forum” is selected.
- When you are ready to publish your article, click on “Submit”
Upload Images
Before committing the publication to the system, repeat the following steps for each image in your document.
- Place the cursor in the body area of your article where you would like to insert an image.
- Click on the upload icon:
- Click on “Browse…,” locate the image on your hard drive, and click “Open”
- Under “Select a destination directory,” select “Image Upload Directory”
- Click on “Upload”
- Skip the options for resizing images, as these features are not available on the ITSM Community web site.
- Under “Image Location” selection “Body”
- Click on “Place Image and Close Window”
- An HTML reference to your image’s new location has been embedded in your document. It may look like this:
<img src="http://www.itsmcommunity.org/themes/cp_global_images/my_image.jpg" alt="image" name="image" width="424" height="80" />
- The “alt” information is what users who cannot render images will see. The “name” information is what users whose mouse “hovers” over the image will see as a pop-up description. Edit these values if you like.