Maintaining NCAVP Website Content With Macromedia Contribute™ 1
What Files May Be Edited? 1
Editing Featured Content Snippets 1
Editing Publication Document Snippets 2
Applying Text Styles 2
Inserting Links 3
Inserting Images 4
Inserting Tables 5
What Files May Be Edited?
§Only edit HTML Snippet files. These files have a file extension of '.htm', and they are all located in the '/common/document_files/' folder and it's sub-folders. DO NOT EDIT ANY OTHER FILES outside of this folder, or any files with any other file extension when using Contribute, as doing so can cause damage to these pages.
All Body Content HTML Snippets for all website pages with modifiable content are located in the '/common/document_files/snippets/' folder.
Any Publication Document that is displayed on the site as HTML also exists as an HTML Snippet (along with a data record for the Document in the database pointing the folder and file name; the folder and file name in the database is what allows the website application to find and display the document). These HTML Document Snippets are located in the various sub-folders of the '/common/document_files/' folder, each in a folder corresponding to their Document Type. For example, the Document Body HTML Snippets of all Media Releases are located in the '/common/document_files/MediaReleases/' folder. (See Editing Publication Document Snippets below.)
'Home-FeatureTop.htm' the Featured Item on the top of the home page, w/ a yellow background
'Home-FeatureBottom.htm' the Featured Item on the bottom of the home page, w/ a gray-blue background
'Nav-Feature.htm' the Featured Item below the SEARCH area on every page
§ Do NOT change the width of the table which surrounds the content in these HTML Snippets. For 'Home-FeatureTop.htm' do not change the height either. If the editing you do to the content in the table does change the size of the table inappropriately, press [Ctrl]-Z / Undo until it returns to it's preset size. Changing the width of the tables in these snippets will change the layout of the website so that design elements on the pages are no longer aligned. Changing the height of 'Home-FeatureTop.htm' will change the layout of the home page so that the top Feature is out of alignment with the left-hand navigation.
§On these Featured Content HTML Snippets only, you can use any Font Name, Size, Color or Style you desire (see Applying Text Styles below). You should, however, restrict the fonts to Times New Roman, Arial and Verdana to ensure optimal browser compatibility. If you want to use other fonts, you can create an image file and use that instead of or in addition to the text you include.
You can also change the alignment of the table itself in the Featured Content area, as well as text elements within the table, as desired.
Editing Publication Document Snippets
There are 6 Publications Types that can be entered in the database. Each of these Types can have a Document that is an HTML page on the website; in this case the page Body Content of the HTML page is an HTML Snippet, located in one of these sub-folders in the '/common/document_files/ ' folder:
§To create a new Publication Document HTML Snippet:
Open the Snippet Template file: '/common/document_files/SnippetTemplate.htm' and immediately save it as the new file, in the sub-folder appropriate to the Publication Type;
Replace the content of the newly saved file with the text of the new Document. IMPORTANT: if you cut & paste the content, you must only paste plain text, not Word-formatted text or text from a formatted email, etc. Otherwise the formatting of the copied document can interfere with the website application being able to process the HTML Snippet;
Apply any permitted Text Styles to the Document (see Applying Text Styles below);
Insert any desired links and images into the Document (see Inserting Links and Inserting Images below);
Apply the "FeatureOnHome" style to any text wanted on the Home Page. IMPORTANT: Do NOT apply this style to any text block containing an image, as the Home Page layout can be broken if an image is included in the text displayed there.
Applying Text Styles
§ Only use the following Styles from the list:
§ You can use Bold and Italics as desired. You can also set text alignment, indentation, and create numbered or bulleted lists. Bulleted lists will use this image for the bullet:
§ To avoid confusion, do NOTunderline text, as this indicates a link in HTML.
§ Do NOT change the Font Name or Size, as this will interfere with the chosen website style sheets.
When inserting links, click on the 'Link' toolbar button, and select 'Browse to Web Page…'
§ If you want to link to a web page on the NCAVP website:
In the bottom of the 'Insert Link' window, click on the button, to display the 'HREF:' text box, if it isn't already displayed;
Then click on the button to select the desired web page. Do NOT link to an HTML Snippet in the '/common/document_files/snippets/' folder; only link to pages outside of the '/common/ ' folder with a '.aspx' file extension, as these are the actual web pages.
Navigate to the page you want to link to (consult the Site Map document to determine what the folder and page name is) and double-click on it, or click on it and then click the 'OK' button. The selected page name will be displayed in the 'HREF:' text box, looking something like this: ../../../issues/Bias.aspx ;
Remove the leading dots and slashes, so that the page name in the 'HREF:' text box starts with a slash, and is followed by the initial folder name, looking like this: /issues/Bias.aspx.cs ;
Then click the 'OK' button in the 'Insert Link' window;
[optional] If you want to include the website's standard "go to a page on our site" icon, insert the image file '/common/images/linkDetail.gif' If you do this, you should make the icon a link to the document as well, and make sure that 'Alignment' = 'Top' is selected for the image (see Inserting Images below).
§ If you want to link to a web page on a different website:
Enter the address of the website page you want to link to and click 'OK'. The selected website address will be displayed in the 'Web address (URL):' text box.;
Click the 'OK' button in the 'Insert Link' window.
[optional] If you want to include the website's standard "go to an off-site web page" icon, insert the image file '/common/images/linkURL.gif' If you do this, you should make the icon a link to the document as well, and make sure that 'Alignment' = 'Top' is selected for the image (see Inserting Images below).
§ If you want to link to a document / file on either the NCAVP website or another website:
1st follow the steps above appropriate to either the NCAVP or a different website, linking to the document / file instead of a web page.
It's polite on a website to include an indication of the type and size of a file that's linked to, so that the user knows if they can open the file, and what kind of download time to expect when they click on the link. After the link to the file, enter the file type and file size of the file in square brackets, and apply the Small style to this info. The file size should be an integer value followed by KB (e.g. 345 KB), or if it's larger than 1MB, a single decimal place should be included (e.g. 2.3 MB). It should look something like this: [Adobe PDF; 23 KB]
[optional] When linking to a document / file, you may also want to include the appropriate document icon image file from the '/common/images/' folder for the document file type:
'linkPDF.gif' 'linkDOC.gif' 'linkXLS.gif' If you do this, you should make the icon a link to the document as well, and make sure that 'Alignment' = 'Top' is selected for the image (see Inserting Images below).
When inserting images, click on the 'Image' toolbar button…
§ If the image file you want to insert already exists on the website in the '/common/images/' folder, select 'From Website…' and proceed to step 2 (if you're not sure, do this to determine if it's there).
§ If the image is new, and you're certain an image of the same name doesn't exist on the website in the '/common/images/' folder, select 'From My Computer…' and proceed to step 2. (If you're not sure, select 'From Website…' and check if it's there).
§ If the image on the website needs to be replaced with a newer version, you should upload it manually and then select 'From Website…' to select it, as selecting a file with the same name as a file on the website using 'From My Computer…' causes the image to be given a new system generated name on the website that you may not recognize at a later time. Locate the newer image file on your hard drive or the network, and then drag and drop it to the '/common/images/' folder in the Web Folder for the NCAVP website, replacing the existing file. Then select 'From Website…' to insert the image.
If the image file exists on the website in the '/common/images/' folder, navigate to the folder and double-click on the file, or click on it and then click the 'OK' button.
[optional] Once the image is inserted, you might want to adjust it's alignment or other properties; right-click on the image and select 'Image Properties…' to open the properties window. NOTE: if you're inserting a link icon next to text, you always want to select 'Alignment' = 'Top' for the image. You probably don't want to adjust the size, as that will skew the image.
[optional] You may also want to make the image a link to another website page or document. Click once on the image to select it, and then follow the steps to create a link (see Inserting Links above).
To insert a table, click on the 'Table' toolbar button…
§ When initially inserting the table, after selecting the desired number of rows and columns, you should set the 'Border thickness', 'Cell padding' and 'Cell spacing' values so that either there is no border, or only a single pixel width border. For no border, set 'Border thickness' to 0, and leave 'Cell padding' and 'Cell spacing' empty. If you want a single pixel border, set 'Border thickness' to 1, and 'Cell padding' and 'Cell spacing' to 0.
§IMPORTANT: To preserve the consistency of the website layout on every page, and not exceed the dimensions of an 800 x 600 screen, an inserted table should never exceed a width of 550. You can right-click on a table and select 'Table Properties…' to see what the table width is. If a table's width exceeds 550, the content will be forced to stretch to the right.