Recycled WikiContent

From Gramps
Revision as of 09:31, 19 December 2019 by Bamaustin (talk | contribs) (Insert reference commands for transclude & substitute)
Jump to: navigation, search

Many instructional documents must repeatedly present subsets of instructions. Synchronizing all the instances of that subset repeated throughout the wiki is a poor use of energy.

These subsections can be named as separate templates and then simply included (by name) in the Wiki pages. The MediaWiki system will look up & embed the expanded subsection into the page.

By editing the template, all the pages using that template will be updated instantly. This is the handled much like re-using image files on web pages.

However, too many templates create a filing mess. An alternative to ripping out a potentially re-useable chunk of text occurs when the original document has only a single re-useable subsection. In that case, you can mark off the desirable subsection and use the original page like a template.

The following subsection under the divider bar is a Transclusion (transcribed inclusion) from the Gramps 5.1 Wiki Manual - Preface page. (The <onlyinclude>...</onlyinclude> tags were added the original page around the re-useable subsection.

It remains 'transcluded' with a single line:

{{:Gramps_5.1_Wiki_Manual_-_Preface}}

But all that same content could just as easily been duplicated (like a a 'copy&paste') with the line:

{{subst:Gramps_5.1_Wiki_Manual_-_Preface}}

In this book, some words are marked with special typography:

  • Internal links (aka: hotlinks, hyperlinks) mark terminology or procedures that are explained more completely elsewhere (on the same webpage or on another webpage) internally within the Gramps-Project wiki.
  • External links mark terminology that is not specific to Gramps where well-defined explanations can be found on a website external to the Gramps-Project wiki.
  • Applications
  • Commands you type at the command line
  • Filenames or Filenames
  • Replaceable text
  • Labels for buttons and other portions of the graphical interface. A trailing ▴ and ▾ in a column header indicates the sort order for table column. ◂ more headers or tabs ▸
  • Hint text for hover or roll-over hints (aka Tooltips) that identify elements of the graphical interface
  • Menu selections look like this: Menu -> Submenu -> Menu Item (Spaces should enclose the -> to make webpage auto-translation recognize menu words.) Gramplet pop-up menus are marked with a (Down Arrowhead button).
  • Buttons you can click
  • Disclosure triangle node expand or collapse disclosure triangular widget. All the nodes of the tree view mode can be simultaneously collapsed or expanded from the pop-up menu shown by right-clicking.
  • Anything you type in
  • Checked - Checkbox that is ☑ selected
  • Unchecked - Checkbox that is ❏ unselected
  • RadioButton Selected.png - Radio button that is ◉ selected
  • RadioButton Deselected.png - Radio button that is 🔘 deselected

The manual also provides assorted bits of additional information in tips and notes as follows:

Tango-Dialog-information.png
Example Tip

Tips and bits of extra information will look like this.


Gramps-notes.png
Example Note

Notes will look like this.

Finally, there are warnings, notifying you where you should be careful:

Gnome-important.png
Example Warning

This is what a warning looks like. If there's a chance you'll run into trouble, you will be warned beforehand.