Difference between revisions of "Basics"

From Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ Here you find the Basics of ConTeXt '''document structure''' and '''text formatting''' (because paragraphs, emphasis, verbatims, quotes... also contributes to the st...")
 
m (add link to composing characters)
 
(65 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
Here you find the Basics of ConTeXt '''document structure''' and '''text formatting''' (because paragraphs, emphasis, verbatims, quotes... also contributes to the structure of your documents).
+
Here you find the Basics of ConTeXt '''[[#Document_structure|document structure]]''' and '''[[#Text_formatting|text formatting]]''' (because paragraphs, emphasis, verbatims, quotes, etc also contribute to the structure of your documents).
  
If it can help, there is a [[Dictionary]] of typographical terms.
+
If it helps, there is a [[Dictionary]] of typographical terms. There are also a few references to the [[History of TeX]] (2007); it would benefit from an update.
  
 
<ul style="display: grid;grid-template-columns: repeat(auto-fit, minmax(15em, 1fr)); grid-gap:3rem; justify-content: space-between;list-style: none;padding: 0px;margin: 0px; ">
 
<li style="height: stretch; padding: 10px; border-top: solid 5px #cc3333; box-shadow: 0px 8px 8px gray; background-color: #eeeedc;">
 
 
= Document structure =
 
= Document structure =
  
== ConTeXt Projects ==
+
{{TwoColumnsUnderLevel1
* [[Project structure]]: How to split up content and setup.
+
|
* [[Modes]]: Conditional processing of document
+
; ConTeXt Projects
 
+
:* [[Project structure]] How to split up content and setup.
== Titles, Headings, and Sections ==
+
:* [[Modes]] Conditional processing of document
* [[Titles]]: Chapters, sections, and so forth, and tables of contents.
 
** [[Figures in Headings]]: How to use a figure in place of a section title.
 
** [[Bold Math in Section Titles]]
 
** [[Chapters headers]] A fancy chapter heading
 
* [[Table of Contents]]: How to add and modify Table of Contents
 
 
 
== Page Structure ==
 
* [[Headers and Footers]]: Defining headers and footers with appropriate information.
 
* [[Footnotes]]: Footnotes, endnotes, and related notes.
 
* [[References]]: Automatically referring to pages and labels.
 
* [[PDF Bookmarks and Headers]]
 
* [[Page numbering in words]]
 
  
== Structure-Related Lists ==
+
; Titles, Headings, and Sections
* [[Registers]]: Indexes and other similar word lists.
+
:* [[Titles]]: sectioning and formatting
* [[Bibliography]]: Referenced documents and in-text citations.
+
:* [[Table of Contents]]
* [[Simple Bibliography]]: A simple bibliography module without any database
 
* [[Manual Bibliography]]: A very simple bibliography in a few lines
 
  
</li>
+
; Page Structure
 +
:* [[Headers and Footers]]
 +
:* [[Footnotes]], endnotes, and related notes.
 +
|
 +
; Structure-Related Lists
 +
:* [[Registers]]: Indexes and other similar word lists.
 +
:* [[Bibliography]]: Referenced documents and in-text citations.
  
<li style="height: stretch; padding: 10px; border-top: solid 5px #cc3333; box-shadow: 0px 8px 8px gray; background-color: #eeeedc;">
+
; Referencing
 +
:* [[References]]: Automatically referring to pages and labels.
 +
:* [[Interaction#PDF_Bookmarks|PDF Bookmarks and Headers]]
 +
:* [[Cross Referencing]]: Inline text referencing.
 +
:* [[URL]]: typesetting of URLs references.
 +
}}
  
 
= Text formatting =
 
= Text formatting =
  
== Basic Text Formatting ==
+
{{TwoColumnsUnderLevel1
 +
|
 +
; Basic Text Formatting
 +
:* [[Font Switching]], to change font styles (bold, italic, capitalizing, underline, etc.)
 +
:* [[Right_and_left|Alignment]]
 +
:* [[Indentation]]
 +
:* [[Columns]]
 +
:* [[Color]]
 +
:* [[Verbatim text]]
 +
:* [[Quotes]]
 +
:* [[Framed]]
 +
:* [[Verse]]
 +
:* Initials (dropped caps, dropcaps)
 +
:** placement with {{cmd|placeinitial}}
 +
:** customization with {{cmd|setupinitial}}
 +
:* [[Symbols]]
 +
:* [[Delimiter|Delimiters and breaks]] (delimiting text, specifying line breaks and page breaks)
 +
|
 +
; Structured Text
 +
:* [[Enumerations]]: Itemizations, itemized lists, and bulleted lists.
 +
:* [[Description|Descriptions]]: Lists with text labels, such as definitions.
 +
:* [[Paragraph Enumeration]]: Numbered paragraphs.
 +
:* [[Paragraph Referencing]]: Number all paragraphs for referencing usage
 +
:* [[Tables_Overview|Tables]]: Different ways to create tables in ConTeXt.
 +
}}
  
* [[Font Switching]], to change font styles (bold, italic, capitalizing, underline, etc.)
+
= Further reading =
* [[Indentation]]
 
* Text in [[Columns]]
 
* [[Color]]
 
* [[Verbatim text]]
 
* [[Quotes]]
 
* [[Framed]]
 
* [[Verse]]
 
* [[Initials]] (dropped caps, dropcaps)
 
* [[Symbols]]
 
* [[Faking characters]]
 
* [[Compound words]]
 
* [[Hiding Content]]
 
* [[Delimiter]] to forced linebreak
 
  
== Structured Text ==
+
; [[Unexpected behavior]]: If ConTeXt appears to behave in a counterintuitive way, chances are that it’s actually your intuitions that lack calibration.
* [[Enumerations]]: Itemizations, itemized lists, and bulleted lists.
+
; [[Visual Debugging]]: can facilitate tweaking text formatting
** [[User-Defined Enumerations]]: Defining a new numbering scheme.
+
; [[Sample documents]]: a page is used as a central location for these, but there is also a [[:Category:Sample_documents|dedicated category]] (the two should mostly match).
* [[Description|Descriptions]]: Lists with text labels, such as definitions.
+
; Advanced Document structure
* [[Cross Referencing]]: Inline text referencing.
+
:* [[Hiding Content]]
* [[Paragraph Enumeration]]: Numbered paragraphs.
+
:* [[Makeup]], allowing for custom and temporary header & footer sections.  
* [[Paragraph Referencing]]: Number all paragraphs for referencing usage
 
* [[Tables_Overview|Tables]]: Different ways to create tables in ConTeXt.
 
  
== More advanced Text Formatting ==
+
; Advanced Text formatting
* [[Cropping text]]
+
:* [[Hyphenation]]
* [[Graphical text manipulation]]
+
:* [[composing characters]]
* [[TextBackground]] (includes underlining)
+
:* [[Faking characters]]
* Specially [[Shaped paragraphs]]
+
:* [[Compound words]]
 +
:* [[Cropping text]]
 +
:* [[Scaling Rotating Mirroring Clipping]]
 +
:* [[TextBackground]] (includes underlining)
 +
:* Specially [[Shaped paragraphs]]
 +
:* [[Widows and orphans control]]
 +
:* [[Paragraph last line control]]
 +
:* [[autoinsertnextspace]]
 +
:* [[setuplocalinterlinespace]]
  
</li>
 
</ul>
 
  
 +
{{todo|try to follow the structure of part 1 to help orientation.}}
  
{{Getting started navbox}}
 
  
[[Category:ConTeXt-Issues]]
+
[[Category:Basics]]

Latest revision as of 13:47, 18 February 2021

Here you find the Basics of ConTeXt document structure and text formatting (because paragraphs, emphasis, verbatims, quotes, etc also contribute to the structure of your documents).

If it helps, there is a Dictionary of typographical terms. There are also a few references to the History of TeX (2007); it would benefit from an update.

Document structure

Text formatting

Further reading

Unexpected behavior
If ConTeXt appears to behave in a counterintuitive way, chances are that it’s actually your intuitions that lack calibration.
Visual Debugging
can facilitate tweaking text formatting
Sample documents
a page is used as a central location for these, but there is also a dedicated category (the two should mostly match).
Advanced Document structure
Advanced Text formatting



TODO: try to follow the structure of part 1 to help orientation. (See: To-Do List)