Any document, NASA document or external document, that is referred to in a SWEHB page is a reference. Some references may not be directly called out in the text of the SWE page. These are "implied references. All SWE pages, and most Topic pages, have a Resources Tab. This tab was originally a container for two types of resources: References and Tools. See the SWE-000 - SWE Template or 0.0 Topic Template for formatting information of this tab. The References section contains a bullet list of documents mentioned in the page or appropriate to the content of the page. The following information is displayed for each reference: The Tools Table section was used for listing tools that may be appropriate for use with the SWE or Topic. Starting in NPR 7150.2C the tools list has been suspended and the tools database is no longer beint maintained. The References Table is a database of SWEREF pages that lives in the 7150 space. Each of the other SWEHB spaces has a References Table which displays its data from the 7150 space. Each SWEREF page is built using the the "reference" live template. This is a User Created Template and is based on the "reference" template stored in the 7150 space under Templates in the Space Tools of the Dashboard. The "reference" template is part of the User Templates in the Confluence installation. It uses the Scaffolding Plugin to create data variables and capture values for these variables. A User Created Template called "reference" is stored in the 7150 space. It is this template that is used in SWEREF pages to define the data to be captured. The Source Code for this template is in Wiki Markup language: <a href="https://swehb-pri.msfc.nasa.gov/%data:Link%" class="external-link" rel="nofollow">%data:Link > first 600%</a> Example Reference as it will appear to end user: # [Title|http://www.nasa.gov], Citation where: * Title = Title * Link = http://www.nasa.gov * Citation = Citation | Link \\ {small}Leave blank if none exists{small} | {show-if:action=edit}{text-data:Link|width=600px|height=100px|type=area}{text-data}{show-if}{show-if:action=view}{div:style=width:500px;word-wrap:break-word;}{report-on:injected=true}
<a href="%data:Link%" target="_blank">%data:Link > first 600%</a> Create In a SWEREF page using the naming convention SWEREF-999. The page should be a child of the References Table page in the 7150 space, The easiest way to create a new SWEREF page is to: Edit the new page and you should see the Live Template macro as the only thing on the page. The "reference" template is initiated by the "Live Template" macro. The parameters of the Live template are: After saving the page. select "Edit Contents" from the page menu. This triggers the Scaffolding Plugin to organize the data elements in the page based on the structure described in the "reference" template code. You will be able to provide data for: There are several User Macros that are used to display references is the Resources tabs of SWEs and Topics. Each one is designed for a certain type of page: Short quotes vary from a few words to a short sentence. They are included in-line in the text of a page in the traditional fashion. They are introduced by stating where the quote comes from (title of the reference), and then the quote itself in traditional quotation marks. If a reference is updated and possibly rewritten, some quotes are changed and may not be found verbatim in the updated version of the reference. Long quotes vary from long complex sentences, to strings of sentence fragments (separated with ellipses) to a paragraph or more. These quotes are set apart from the rest of the text in the page in a special form. they are also documented in a special way so that they can be verified when the source reference is updated. The long quote is put into the body of a "Set-Data" macro which is set into the body of a Panel macro. In the event that the "reference" template is broken and cannot be repaired, The following can be recovery can be used. The SWEREF Recover Spreadsheet contains all the SWEREF data from the References Table. It contains data for : The spreadsheet will be updated quarterly and stored as an attachment to this page. Each SWEREF page will be reused and rebuilt if the live template "reference" is broken. On each page perform the following steps:
See edit history of this section
Post feedback on this section
1. Introduction
Explains how references are used and maintained in SWEHB. 1.1 Resources Tab
1.2 References Section
1.2 References Table
2. "Reference" Template
2.1 Source Code
Link \\ {small}Leave blank if none exists{small} {show-if:action=edit}{text-data:Link width=600px height=100px type=area}{text-data}{show-if}{show-if:action=view}{div:style=width:500px;word-wrap:break-word;}{report-on:injected=true}
Title \\ {small}This is the text which will be hyperlinked, if a link exists{small} {text-data:Title width=600px height=100px type=area}{text-data} SWE or Topic {show-if:action=edit}{color:red}Formatting: \\ For SWE, use SWE-xxx \\ For Topic, use Topic 7.xx{color} \\ {show-if}{text-data:SWE width=600px height=100px type=area}{text-data} Citation \\ {small}This contains additional information, which will appear after the title, separated by a comma{small} {text-data:Citation width=600px height=100px type=area}{text-data} Notes \\ {small}More specific directions where to look in the resource for relevant content{small} {text-data:Notes width=600px height=100px type=area}{text-data} 2.2 Use in SWEREF page
3. "refstable" User Macros
4. Quoting From References
4.1 Short / Simple Quotes
4.2 Long Quotes
5. Alternative using Excerpt Macro
5.1 Recover SWEREF Data
5.2 Build Replacement
References in SWEHB
Web Resources
View this section on the websiteUnknown macro: {page-info}
"reference" template code in wiki-markup
Raw source code