Changes

<div style="background(This module is currently not in die distribution. Until it is, you can download it from [http: #FFFFDD">Intro: why</div>/zenlima.com/context/t-pararef-0.8.2.zip here]).

The [https://modules.contextgarden.net/cgi-bin/module.cgi/ruid=1253027735/action=view/id=64 pararef] module understands a paragraph as a full closed block of one thought. This means that inside a paragraph enumerations, formulas etc. can appear. That is why a paragraph must be defined manually via <div style="background: #FFFFDD"code>Singe paragraph: \startParagraph</code > and result<code>\stopParagraph</divcode>.

==Paragraphs== Each paragraph gets numbered started by each title. In order to link to a paragraph it can be reference by the optional parameter <code>reference=...</code> as a text reference. One or more paragraphs can be summarized by a low level title which is displayed as a margin note (margin title) via the optional parameter <code>title=...</code>. <texcode> \startParagraph[reference=...,title=...] ... \stopParagraph</texcode> Here how a single paragraph with a title looks like: <texcode>\usemodule[pararef] \starttext\startParagraph[title={Paragraph heading}]\input tufte\stopParagraph\stoptext<div style/texcode> [[Image:t-pararef-1.jpg]]  ==References=="background Now the more practical part: the paragraph referencing. To reference to an paragraph the package pararef makes use of the [[Cross Referencing|crossref]] module. Here a simple usage example: #FFFFDD" <texcode>Multi paragraphs \usemodule[pararef]\usemodule[crossref] \starttext \startchapter[title={Lorem ipsum}]\startsection[title={Dolor sit}] \startParagraph\input tufte \stopParagraph \startParagraph[reference=ref1]\input tufte \stopParagraph \startParagraphHere are two references to destinations on the same page:\startitemize[nowhite]\item ref1 should be: para. 1.1/2 and is: \crossref[label={para.}][ref1]\item ref2 should be: sec. 1.2 and is: \crossref[label={sec.}][ref2]\stopitemizeHere is one references with brakets:\startitemize[nowhite]\item ref1 should be: (para. 1.1/2) and is: \crossref[left={(},right={)},label={para.}][ref1]\stopitemize\stopParagraph \stopsection\startsection[title={Amet},reference=ref2] \page \startParagraphHere are two referencesto destinations on an other page:\startitemize[nowhite]\item ref1 should be: para. 1.1/2 on page 1 and is: \crossref[label={para.}][ref1]\item ref2 should be: sec. 1.2 on page 1 and is: \crossref[label={sec.}][ref2]\stopitemize\stopParagraph \stopsection\stopchapter\stoptext</texcode> [[File:t-pararef-2.jpg]][[File:t-pararef-3.jpg]] ==Text part divider== Each section (subsection, subsubsection etc.) has mostly three parts:* introduction part,* one or several main parts and* summary part.Each part contains one or more paragraphs. To make the logic parts visible the parts are divided by a line <code>\textpartdivider</code>. <texcode>\usemodule[pararef] \starttext \startsection[title={Lorem ipsum}]\startParagraphSome introduction text \input tufte\stopParagraph \textpartdivider \dorecurse{3}{\startParagraphSome main theme text \input tufte\stopParagraph} \textpartdivider \startParagraphSome section summarizing text \input tufte\stopParagraph \stopsection\startsection[title={Doloris sit}]...\stopsection\stoptext</texcode> [[File:t-pararef-4.jpg]] ==Settings== In pararef the colors can be set via two paramters: * <code>textpartdividerColor</code > for the color of the line and result* <code>paragraphNumberColor</code> for the number of the paragraph. They are defined as parameters of the module:<texcode>\usemodule[pararef][textpartdividerColor=...,paragraphNumberColor=...]...</divtexcode> For now the color and style of the paragraph title has to be set via the normal outer margin settings. [[Category:Basics]]