Difference between revisions of "Command/setupalign"

From Wiki
Jump to navigation Jump to search
(→‎Syntax: left->flushleft, right -> flushright)
(A description of all the keys involved.)
Line 15: Line 15:
 
</table>
 
</table>
  
−
== Description ==  
+
== Description of keys ==  
  
 +
=== Horizontal alignment ===
 +
{|
 +
|-
 +
| <code>normal</code> *or* <code>width</code> *or* <code>yes</code>
 +
| justified alignment
 +
|-
 +
|<code>middle</code>
 +
|centered lines
 +
|-
 +
|<code>flushleft</code> *or* <code>no</code> *or* <code>right</code>
 +
|left-aligned (The <code>right</code> is from 'ragged-right'. Don't use it.)
 +
|-
 +
|<code>flushright</code> *or* <code>left</code>
 +
|right-aligned (Again, better to not use <code>left</code>.)
 +
|-
 +
|<code>inner</code>
 +
|Flush to inner margin.
 +
|-
 +
|<code>outer</code>
 +
|Flush to outer margin.
 +
|-
 +
|<code>disable</code>
 +
|Used only for oneliners. Equivalent to flushleft, but something called
 +
|<code>\parfillskip</code> is set to zero.
 +
|-
 +
|<code>last</code>
 +
|Justified, with last line centered.
 +
|}
 +
 +
=== How wide do we let the lines get? ===
 +
{|
 +
|-
 +
| <code>wide</code>
 +
| Lets/makes ragged-right/-left/-middle lines to be wider
 +
|-
 +
| <code>broad</code>
 +
| Similar? Used in tables.
 +
|}
 +
 +
=== Where would we like the bottom line to end up? ===
 +
{|
 +
|-
 +
| <code>bottom</code>
 +
| Ragged-ish bottom (the room for variation is but a single lineheight, of course).
 +
|-
 +
| <code>height</code>
 +
| Fill the height: press the last line's baseline against the lower boundary.
 +
|-
 +
| <code>line</code>
 +
| Let the last line's descenders touch the lower boundary.
 +
|}
 +
 +
=== Vertical alignment within boxes, e.g. <code>\framed</code> or table cells ===
 +
{|
 +
|-
 +
| <code>high</code>
 +
| Align to top
 +
|-
 +
| <code>low</code>
 +
| Align to bottom
 +
|-
 +
| <code>lohi</code>
 +
| Vertically centered
 +
|}
 +
 +
=== Predefined combinations ===
 +
{|
 +
|-
 +
| <code>table</code>
 +
| Equivalent to <code>flushleft,broad,high</code>
 +
|-
 +
| <code>reset</code>
 +
| Equivalent to <code>normal</code>.
 +
|-
 +
| <code>center</code>
 +
| Equivalent to <code>middle,broad</code>.
 +
|}
 +
 +
 +
=== Typesetting direction --- which direction do you write in? ===
 +
{|
 +
|-
 +
| <code>lefttoright</code> *or* <code>l2r</code>
 +
| "Hello, world."
 +
|-
 +
| <code>righttoleft</code> *or* <code>r2l</code>
 +
| ".dlrow ,olleH"
 +
|}
 +
 +
=== Nicer justification and microtypography ===
 +
{|
 +
|-
 +
| <code>hanging</code>
 +
| Enable hanging punctuation ('protrusion')
 +
|-
 +
| <code>nothanging</code>
 +
| Disable hanging punctuation
 +
|-
 +
| <code>hz</code>
 +
| Enable slight stretching of characters ('font expansion').
 +
|-
 +
| <code>nohz</code>
 +
| Disable font expansion.
 +
|-
 +
| <code>hyphenated</code>
 +
| Allow hyphenation.
 +
|-
 +
| <code>nothyphenated</code>
 +
| Allow hyphenation.
 +
|-
 +
| <code>lesshyphenation</code>
 +
| Less hyphenation. Not sure if this is relative/additive, or absolute.
 +
|-
 +
| <code>morehyphenation</code>
 +
| More hyphenation. Not sure if this is relative/additive, or absolute.
 +
|-
 +
| <code>tolerant</code>
 +
| Allow uglier final paragraphs (more hyphenations, more stretching) to avoid
 +
overfull hboxes.
 +
|-
 +
| <code>verytolerant</code>
 +
| Allow even uglier paragraphs.
 +
|-
 +
| <code>stretch</code>
 +
| Allow spaces to be stretched extra far. Can be combined with (very)tolerant, and usually is.
 +
|}
  
  

Revision as of 00:52, 21 February 2012

\setupalign

Syntax

\setupalign[...]
[...] width flushleft flushright middle inner outer wide broad height bottom line reset hanging nothanging hyphenated nothyphenated

Description of keys

Horizontal alignment

normal *or* width *or* yes justified alignment
middle centered lines
flushleft *or* no *or* right left-aligned (The right is from 'ragged-right'. Don't use it.)
flushright *or* left right-aligned (Again, better to not use left.)
inner Flush to inner margin.
outer Flush to outer margin.
disable Used only for oneliners. Equivalent to flushleft, but something called \parfillskip is set to zero.
last Justified, with last line centered.

How wide do we let the lines get?

wide Lets/makes ragged-right/-left/-middle lines to be wider
broad Similar? Used in tables.

Where would we like the bottom line to end up?

bottom Ragged-ish bottom (the room for variation is but a single lineheight, of course).
height Fill the height: press the last line's baseline against the lower boundary.
line Let the last line's descenders touch the lower boundary.

Vertical alignment within boxes, e.g. \framed or table cells

high Align to top
low Align to bottom
lohi Vertically centered

Predefined combinations

table Equivalent to flushleft,broad,high
reset Equivalent to normal.
center Equivalent to middle,broad.


Typesetting direction --- which direction do you write in?

lefttoright *or* l2r "Hello, world."
righttoleft *or* r2l ".dlrow ,olleH"

Nicer justification and microtypography

hanging Enable hanging punctuation ('protrusion')
nothanging Disable hanging punctuation
hz Enable slight stretching of characters ('font expansion').
nohz Disable font expansion.
hyphenated Allow hyphenation.
nothyphenated Allow hyphenation.
lesshyphenation Less hyphenation. Not sure if this is relative/additive, or absolute.
morehyphenation More hyphenation. Not sure if this is relative/additive, or absolute.
tolerant Allow uglier final paragraphs (more hyphenations, more stretching) to avoid

overfull hboxes.

verytolerant Allow even uglier paragraphs.
stretch Allow spaces to be stretched extra far. Can be combined with (very)tolerant, and usually is.


Example

See also

Retrieved from "https://wiki.contextgarden.net/index.php?title=Command/setupalign&oldid=13607"