1,804
edits
Changes
Jump to navigation
Jump to search
Line 3:
Line 3: − + − + Line 151:
Line 151: − + Line 171:
Line 171: − + Line 225:
Line 225: − + Line 232:
Line 232: − + Line 240:
Line 240: − + Line 248:
Line 248: − + Line 255:
Line 255: − + Line 266:
Line 266: − + Line 344:
Line 344: − + − + − +
→Revision History
| mod_summary = Customize the format and content of citations (individual pages) and sources (browsing page).
| mod_summary = Customize the format and content of citations (individual pages) and sources (browsing page).
| mod_validation =
| mod_validation =
| mod_last_update = 13 Sep 2021
| mod_last_update = 17 Sep 2021
| download_link = [https://lindell-herndon.org/mods/mod-cite-master-v13.0.0.9-rc1.zip v13.0.0.9-rc1]{{Tv1304}}<hr style="clear: both;"/>[https://lindell-herndon.org/mods/mod-cite-master-v13.0.0.8d.zip v13.0.0.8d]{{Tv130}}<hr style="clear: both;"/>[https://lindell-herndon.org/mods/mod-cite-master-v12.0.0.8d.zip v12.0.0.8d]{{Tv120}}<hr style="clear: both;"/>
| download_link = [https://lindell-herndon.org/mods/mod-cite-master-v13.0.0.9-rc2.zip v13.0.0.9-rc2]{{Tv1304}}<hr style="clear: both;"/>[https://lindell-herndon.org/mods/mod-cite-master-v13.0.0.8d.zip v13.0.0.8d]{{Tv130}}<hr style="clear: both;"/>[https://lindell-herndon.org/mods/mod-cite-master-v12.0.0.8d.zip v12.0.0.8d]{{Tv120}}<hr style="clear: both;"/>
| download_stats =
| download_stats =
| mod_author = [[User:wrherndon|Bill Herndon]]
| mod_author = [[User:wrherndon|Bill Herndon]]
=== Format Instruction Sets ===
=== Format Instruction Sets ===
PHP arrays are used to associate GEDCOM tags with format instructions. A typical set of instructions for a group of source fields might look like the following:
PHP arrays are used to associate GEDCOM tags with format instructions. A typical set of instructions for a group of source fields might look like the following:
<code>
<pre>
$book_format_inst = array(
$book_format_inst = array(
'AUTH' => array(
'AUTH' => array(
)
)
...
...
</code>
</pre>
Four instruction sets are depicted and associated with the AUTH (''author''), TITL (''title''), PUBL (''publisher'') and the _CDTE (''citation date'') fields. The first will be displayed in plain typeface (not required, but there is no harm in specifying it) and will be followed by a comma. The second will be displayed in bold-italics and followed by a space. The third will default to plain typeface, surrounded by parenthesis, and followed by a comma and then a line-break. The fourth field, a date, will be formatted according to the PHP format string 'F j, Y', placed in angle brackets, and followed by a comma.
Four instruction sets are depicted and associated with the AUTH (''author''), TITL (''title''), PUBL (''publisher'') and the _CDTE (''citation date'') fields. The first will be displayed in plain typeface (not required, but there is no harm in specifying it) and will be followed by a comma. The second will be displayed in bold-italics and followed by a space. The third will default to plain typeface, surrounded by parenthesis, and followed by a comma and then a line-break. The fourth field, a date, will be formatted according to the PHP format string 'F j, Y', placed in angle brackets, and followed by a comma.
Any custom event associated with a source or citation can be formatted by referring to its GEDCOM tag and creating a format instruction set. For example, Lindell-Herndon Genealogy has a custom ''Endnote Reference'' (represented by GEDCOM tag ''_EREF'') attached to every source. This is used at the beginning of each source and citation entry and is formatted in bold with surrounding brackets. The format instruction set looks like this:
Any custom event associated with a source or citation can be formatted by referring to its GEDCOM tag and creating a format instruction set. For example, Lindell-Herndon Genealogy has a custom ''Endnote Reference'' (represented by GEDCOM tag ''_EREF'') attached to every source. This is used at the beginning of each source and citation entry and is formatted in bold with surrounding brackets. The format instruction set looks like this:
<code>
<pre>
'_EREF' => array(
'_EREF' => array(
'typeface' => 'bold',
'typeface' => 'bold',
),
),
...
...
</code>
</pre>
=== Source Specifications ===
=== Source Specifications ===
The following is an example of a source specification for type 'Book':
The following is an example of a source specification for type 'Book':
<code>
<pre>
$citem_format_spec['Book'] = array(
$citem_format_spec['Book'] = array(
'name' => '',
'name' => '',
'tags' => $book_format_inst
'tags' => $book_format_inst
);
);
</code>
</pre>
This specifications associates the format instructions contained in ''$book_format_inst'' with the source type ''Book'' and instructs Citation Master to add a period after all such sources.
This specifications associates the format instructions contained in ''$book_format_inst'' with the source type ''Book'' and instructs Citation Master to add a period after all such sources.
Citation Master v9 adds the capability of associating different instruction sets depending on whether a source is being rendered or a citation is being rendered. This supports creating "short form" citations like one finds in scholarly publications. To use this feature, modify the 'tags' attribute of a source specification in the manner depicted below:
Citation Master v9 adds the capability of associating different instruction sets depending on whether a source is being rendered or a citation is being rendered. This supports creating "short form" citations like one finds in scholarly publications. To use this feature, modify the 'tags' attribute of a source specification in the manner depicted below:
<code>
<pre>
$citem_format_spec['Book'] = array(
$citem_format_spec['Book'] = array(
'name' => '',
'name' => '',
)
)
);
);
</code>
</pre>
The instruction set, ''$book_short_format_inst'', would contain the modified formatting instructions for books when displayed as citations. ''$book_format_inst'' would continue to be used for books when displayed as sources (showsource.php and browsesources.php).
The instruction set, ''$book_short_format_inst'', would contain the modified formatting instructions for books when displayed as citations. ''$book_format_inst'' would continue to be used for books when displayed as sources (showsource.php and browsesources.php).
! Comments
! Comments
|- valign="top"
|- valign="top"
| 13.0.0.9-rc1
| 13.0.0.9-rc2
| 13 Sep 2021
| 17 Sep 2021
| 1st release candidate for PHP-8 compatibility, 'thumbnail' feature, and 'display context' feature.
| 2nd release candidate: More PHP-8 fixes; formatting updates for the 'thumbnail' feature w/CSS; removal of the option protection flag for 'show thumbnails'.
|- valign="top"
|- valign="top"
| - 11.1.2.8b<br/>- 11.1.0.8b<br/>- 11.0.0.8b
| - 11.1.2.8b<br/>- 11.1.0.8b<br/>- 11.0.0.8b
