Difference between revisions of "Basics"

From Wiki
Jump to navigation Jump to search
(→‎Text formatting: Minor grammar cleanup; slightly changed the "Delimiter" section so it mentions page breaks as well as line breaks)
Tags: Mobile web edit Mobile edit
(40 intermediate revisions by 2 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. There is also an few reference about the [[History of TeX]] (2007, it would benefit from an update).
+
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]]: sectioning and formatting
 
* [[Table of Contents]]
 
 
 
== Page Structure ==
 
* [[Headers and Footers]]
 
* [[Footnotes]], endnotes, and related notes.
 
  
== 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]]
  
== Referencing ==
+
; Page Structure
* [[References]]: Automatically referring to pages and labels.
+
:* [[Headers and Footers]]
* [[PDF Bookmarks and Headers]]
+
:* [[Footnotes]], endnotes, and related notes.
</li>
+
|
 +
; 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
 
+
|
* [[Font Switching]], to change font styles (bold, italic, capitalizing, underline, etc.)
+
; Basic Text Formatting
* [[Indentation]]
+
:* [[Font Switching]], to change font styles (bold, italic, capitalizing, underline, etc.)
* [[Columns]]
+
:* [[Right_and_left|Alignment]]
* [[Color]]
+
:* [[Indentation]]
* [[Verbatim text]]
+
:* [[Columns]]
* [[Quotes]]
+
:* [[Color]]
* [[Framed]]
+
:* [[Verbatim text]]
* [[Verse]]
+
:* [[Quotes]]
* [[Initials]] (dropped caps, dropcaps)
+
:* [[Framed]]
* [[Symbols]]
+
:* [[Verse]]
* [[Delimiter]] to forced linebreak
+
:* [[Initials]] (dropped caps, dropcaps)
 
+
:* [[Symbols]]
== Structured Text ==
+
:* [[Delimiter]] manipulating line breaks and page breaks
* [[Enumerations]]: Itemizations, itemized lists, and bulleted lists.
+
|
** [[User-Defined Enumerations]]: Defining a new numbering scheme.
+
; Structured Text
* [[Description|Descriptions]]: Lists with text labels, such as definitions.
+
:* [[Enumerations]]: Itemizations, itemized lists, and bulleted lists.
* [[Cross Referencing]]: Inline text referencing.
+
:* [[Description|Descriptions]]: Lists with text labels, such as definitions.
* [[Paragraph Enumeration]]: Numbered paragraphs.
+
:* [[Paragraph Enumeration]]: Numbered paragraphs.
* [[Paragraph Referencing]]: Number all paragraphs for referencing usage
+
:* [[Paragraph Referencing]]: Number all paragraphs for referencing usage
* [[Tables_Overview|Tables]]: Different ways to create tables in ConTeXt.
+
:* [[Tables_Overview|Tables]]: Different ways to create tables in ConTeXt.
</li>
+
}}
</ul>
 
  
 +
= Further reading =
  
== More advanced Text Formatting ==
+
; [[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 [[:Category:Sample_documents|dedicated category]] (the two should mostly match).
 +
; Advanced Document structure
 +
:* [[Hiding Content]]
 +
:* [[Makeup]], allowing for custom and temporary header & footer sections.
  
* [[Faking characters]]
+
; Advanced Text formatting
* [[Compound words]]
+
:* [[Hyphenation]]
* [[Hiding Content]]
+
:* [[Faking characters]]
* [[Cropping text]]
+
:* [[Compound words]]
* [[Graphical text manipulation]]
+
:* [[Cropping text]]
* [[TextBackground]] (includes underlining)
+
:* [[Scaling Rotating Mirroring Clipping]]
* Specially [[Shaped paragraphs]]
+
:* [[TextBackground]] (includes underlining)
* [[Widows and orphans control]]
+
:* Specially [[Shaped paragraphs]]
* [[Paragraph last line control]]
+
:* [[Widows and orphans control]]
* [[autoinsertnextspace]]
+
:* [[Paragraph last line control]]
* [[setuplocalinterlinespace]]
+
:* [[autoinsertnextspace]]
 +
:* [[setuplocalinterlinespace]]
  
{{todo|Warning: to be structured.}}
 
  
 +
{{todo|try to follow the structure of part 1 to help orientation.}}
  
{{Getting started navbox}}
 
  
[[Category:ConTeXt-Issues]]
+
[[Category:Basics]]

Revision as of 07:07, 15 June 2020

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)