Template:How do I

From Gramps
Jump to: navigation, search
Gnome-important.png
🚧 Work In Progress

This wikipage is an outline from a template being roughed in. Please don't edit just yet. Instead, contribute suggestions on the Discussion page.

This page is not planned be linked to a public page until about 2 weeks after 26 November 2020.

If this notice remains after that date, please feel welcome to remove this notice and consider the content 'fair game' for unlimited editing.

See also

The Group As name override
unify similar surmanes [sic] thread
threads with "Group As name"


The <IncludeOnly> tagged information is ignored until a template is transcluded. These tags suppress elements from being parsed for application to the original template. The usage below keeps the Template:How_do_I page itself from being indexed in those Categories.

<includeonly>
{{DEFAULTSORT:How do I...new category location|noreplace}}
[[Category:Tutorials]]
[[Category:WikiContributors]]
[[Category:How do I...]]
</includeonly>



Paste the raw Tutorials outline for the How Do I... article above the See also section. This might start with pasting in a copy of a useful thread from one of the Gramps maillists.


Saving this file as a 'work in progress' will insert the code behind this reference template. (Preview only show the results, not the markup formatting control.) You can use the appended special formatting example template to pre-populate a virtual Copy&Paste clipboard. Snip pieces to paste special formatting to enhance the outline.


Adding a feature documentation link pointing to the introduction of the interface element in the wiki will relieve you of the burden explaining how to find the feature.

Finding a Gramps Glossary term to link may be easier than choosing the best introductory section in the wiki.

 [[Gramps_Glossary#active_person|Active Person]]
 [[Gramps_Glossary#P|Primary Object]]

Glossary terms (like Active Person above) are normally lowercase and use an underscore between words. They have a brief description and may already have the introductory text and practical tutorial linked. You can fall back to the Letter index (like using 'P' with Primary Object above) if you don't know the exact entry.

Since most of these How do I... tutorials are likely to have been prompted by a MailList discussion, a set of example 'See also' link are included for reference.

Pointing the maillist archived thread link to the original message that inspired the tutorial give proper credit for the idea & reveals the background discussion.

Pointing another link to a good search phrase for the archive allows similar discussions to be explored.


Once the tutorial Preview is satisfactory, save a revision of the document. Then clean out the virtual Copy&Paste clipboard cluttering up your tutorial and save a final revision.


To remove the virtual Copy&Paste clipboard, simply delete everything from the beginning of this section to the bottom of the document. It is all disposable.

If the Copy&Paste clipboard is needed again, simply paste the following line at the end of the Edit box, Save a revision, & edit again.(Previewing isn't enough... a revision must be saved.)

   {{subst:Template:How_do_I}}

Other wiki Templates can be used as virtual Copy&Paste clipboards in the same way.


Writing a 'How do I...' article.

{{subst:Gramps_{{man version}}_Wiki_Manual_-_Preface}}
{{subst:WikiContributorRecruiting}

(Section)

Stub, english (default)

Gramps-notes.png

Please update or expand this section.


Gramps-notes.png

Ébauche

À compléter !

Si vous pouvez aider à la traduction ou l'adapter à la culture francophone.

N'hésitez pas à améliorer cette page.


Stub, french

Embeddable Snippets (Subsection)

Icons

Dashboard Dashboard
People People
Relationships Relationships
Family Family Families
Charts Charts
Events Events
Places Places
Geography Geography
Sources (v3.4.x) Sources
Citations Citations
Repositories Repositories
Media Media
Notes Notes
more of the standard icons

List object tools
STOCK_ADD STOCK_INDEX (used for share) STOCK_EDIT STOCK_REMOVE Symbol question.svg Symbol question.svg
Add Share Edit Remove Move
Upwards
Move
Downwards

Text formatting (Level 2 Subsection)

italic, bold, bold & italic

Images (Level 3 Subsection)
Fig. .1 A screenshot caption

Logo

Annotations of User Activities (Level 4 Subsection)
  • Commands you type at the command line
  • Filenames or Filenames
  • Replaceable text
  • Labels for buttons and other portions of the graphical interface
  • hint text for roll-over tooltip hints that identify elements of the graphical interface
  • Menu selections look like this: Menu ➡ Submenu ▶ Menu Item (always pad unicode symbols like these arrows with spaces so that robot translators see recognizable words)
  • Pop-up menu down arrowhead, (triangle) button
  • Buttons you can click
  • CTRL+D see Keybindings for a list of keyboard combinations used in Gramps.
  • Anything you type in
  • Checked - Selected Checkbox ☑ template
  • Unchecked - Checkbox that is ❏ unselected

Boxed annotations

Tango-Dialog-information.png
Title of Tip

Tips text.

Gramps-notes.png
Example Note

Notes text.

Gnome-important.png
WarningTitle/Heading

warning text