# Difference between revisions of "Paragraph Referencing"

This 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 \startParagraph and \stopParagraph.

## Paragraphs

Each paragraph gets numbered started by each title. In order to link to a paragraph it can be reference by the optional parameter reference=... 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 title=....

 \startParagraph[reference=...,title=...]
...
\stopParagraph


Here how a single paragraph with a title looks like:

\usemodule[pararef]

\starttext
\input tufte
\stopParagraph
\stoptext


## References

Now the more practical part: the paragraph referencing. To reference to an paragraph the package pararef contains the function \crossref

\crossref[]
\crossref[brakets=...,text=...][]


Here a simple usage example:

\usemodule[pararef]

\starttext

\startchapter[title={Lorem ipsum}]
\startsection[title={Dolor sit}]

\startParagraph
\input tufte
\stopParagraph

\startParagraph[reference=ref1]
\input tufte
\stopParagraph

\startParagraph
Here are two references to destinations on the same page:
\startitemize[nowhite]
\item ref1 should be: para. 1.1/2 and is: \crossref[text={para.}][ref1]
\item ref2 should be: sec. 1.2 and is: \crossref[text={sec.}][ref2]
\stopitemize
Here is one references with brakets:
\startitemize[nowhite]
\item ref1 should be: para. 1.1/2 and is: \crossref[brakets=yes,text={para.}][ref1]
\stopitemize
\stopParagraph

\stopsection
\startsection[title={Amet},reference=ref2]

\page

\startParagraph
Here are two references to destinations on an other page:
\startitemize[nowhite]
\item ref1 should be: para. 1.1/2 on page 1 and is: \crossref[text={para.}][ref1]
\item ref2 should be: sec. 1.2 on page 1 and is: \crossref[text={sec.}][ref2]
\stopitemize
\stopParagraph

\stopsection
\stopchapter
\stoptext


## 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 \textpartdivider.

\usemodule[pararef]

\starttext

\startsection[title={Lorem ipsum}]
\startParagraph
Some introduction text \input tufte
\stopParagraph

\textpartdivider

\dorecurse{3}{
\startParagraph
Some main theme text \input tufte
\stopParagraph
}

\textpartdivider

\startParagraph
Some section summarizing text \input tufte
\stopParagraph

\stopsection
\startsection[title={Doloris sit}]
...
\stopsection
\stoptext


## Settings

Often references (or links) are printed in a different color than the normal text. In pararef the colors can be set via three paramters:

• crossrefColor for the entire reference text,
• textpartdividerColor for the color of the line and
• paragraphNumberColor for the number of the paragraph.

They are defined as parameters of the module:

\usemodule[bgcolor][crossrefColor=...,textpartdividerColor=...,paragraphNumberColor=...]
...


The brakets and text part for \crossref can also be adjusted or extended with other languages:

\setupparareftext[en][braketOpen={(}]
\setupparareftext[en][braketClose={)}]
\setupparareftext[en][atpageLeft={ on page }]
\setupparareftext[en][atpageRight={}]
\setupparareftext[de][braketOpen={(}]
\setupparareftext[de][braketClose={)}]
\setupparareftext[de][atpageLeft={ auf Seite }]
\setupparareftext[de][atpageRight={}]


For now the color and style of the paragraph title has to be set via ......