Changes

Jump to navigation Jump to search
1,162 bytes added ,  11:51, 12 June 2012
space-gobbling fixed in mkiv
{{todo|This FAQ needs to have a lot of things worked on. To avoid clutter from repeated TODO tags, just note missing answers with "...", and put notes about missing information in parentheses.}}
 
== ConTeXt General ==
=== What is ConTeXt? ===
:It is a document production system based on Donald Knuth's [[http://www.tug.org/ TeX]]. It is a set of high-level macros written in the (somewhat arcane) TeX language, and these macros simplify the task of designing layouts, making hyperlinks, etc.
=== How does ConTeXt versioning work? ===
:There are 3 different typesetting engines that work with ConTeXt: pdfTeX, XeTeX and LuaTeX. MkIV works only with LuaTeX, MkII with any one of the engines (pdfTeX is the default). Font setups (typescripts) differ per engine.
:ConTeXt releases are identified by a time stamp, e.g. ''2010.06.23 12:45''. At most times, there is both a ''current'' and a ''beta'' ConTeXt release package available. As explained above, both packages contain MkII and MkIV, the difference between ''current'' and ''beta'' is that the latter contains the unstable developments to MkIV for testing by power users.
:Since "betas" are declared "current" only a few times a year and no bugfixes happen for "currents" (in contrary to "stable" branches in many software projects), you’re mostly better off with beta. It has some bugs fixed, bur mostly some new bugs. If you need a really stable and reliable system and can’t wait a few days for a fix, stick with MkII.
 
== Starting with ConTeXt ==
 
=== How do I install ConTeXt? ===
:See [[Installation]]
=== Is there a hello-world document? ===
:Yes. See [[First Document]] and [[Hello world]].
=== Is ConTeXt free (libre, open source) software? ===
:Yes. See the [[Read Me]] page for details.
 
=== How do I install ConTeXt? ===
 
:See [[Installation]]
=== Does ConTeXt support Unicode? ===
:Yes. It supports Unicode (UTF-8). In [[XeTeX]] and [[LuaTeX]] it is the default input encoding, while you need to use <cmd>enableregime</cmd><tt>[utf-8]</tt> command when working with [[pdfTeX]]. See also [[Encodings and Regimes]] (This needs a bit of elaboration!)
=== Why does <code>\startalignment[right]<should I only use letters, digits and hyphens in file/code> or <code>\framed[align=right]{some text}</code> align my text left instead of right and vice versapath names? ===:This is for backward compatibility with older versions; Please see section "Files" of the [http://pmrb.free.fr/contextref.pdf ConTeXt manual]. And also [Right and left]http://www.ntg.nl/pipermail/ntg-context/2011/057342.html here]for some discussion on the mailing-list. Hans was originally thinking of "ragged right" and "ragged left" alignment. Use '''flushleft''' and '''flushright''' instead == ConTeXt vs.LaTeX ==
=== What are the differences between ConTeXt and LaTeX? ===
:Another advantage is that many good books on LaTeX exist. Documentation of ConTeXt is not satisfactory, as attested by much activity on the mailing list, but is slowly being improved. And good books on the use of ConTeXt need to be written!
 
=== How transcribe this LaTeX macro to ConTeXt? ===
Could you please advice me, how transcribe this macro, controlling that no last line of a paragraph is shorter than the paragraph indenting?
 
<texcode>
\parfillskip=\hsize
\advance\parfillskip by -1.5\parindent
\advance\parfillskip by 0pt minus \parfillskip
\advance\parfillskip by 0pt minus -1em
</texcode>
 
Like this:
<texcode>
\installalign
{block}
{\parfillskip=\hsize
\advance\parfillskip by -1.5\parindent
\advance\parfillskip by 0pt minus \parfillskip
\advance\parfillskip by 0pt minus -1em}
 
% followed by
\setupalign[block]
</texcode>
 
== XML and other formats ==
=== How can I convert a document into RTF or HTML? ===
:[http://archive.contextgarden.net/thread/20050926.213139.45057948.en.html DOC/RTF to ConTeXt via XML]
=== XML: please tell me more about it ===
There is a section on the wiki dedicated to typesetting [[XML]] under the various flavours of ConTeXt.
 
== Fonts and Typography ==
=== Can I change to LaTeX’s Computer Modern's LaTeX font? ===
I see differences in screen between default fonts in ConTeXt (latin modernLatin Modern) and LaTeX (computer modernComputer Modern). Can I switch to latex LaTeX default font?. I think it's more steticalaesthetical.
: No.
: ''(I mean - of course you can; you only need to modify a few type-xxx.tex files and replace lm with cm in the source. But that solution is not/will not be supported officially.)''
:: Is there any tutorial for doing it?
::: ''No. There are no tutorials for the things that one is not supposed to mess with. Take a look at how things are done in those files and replace any occurrence of lm with cm.''
: There might be a workaround for this. Install the [http://cm-unicode.sourceforge.net/ OpenType version of Computer Modern fonts] on your system and use it with <code>simplefonts</code>.
=== Can How can I use some simpler bibliography methodget the “oldstyle numbers” (text figures) in a document? ===The mediaeval numbers can be inserted locally via the font switch <code>\os</code>.
I see With OpenType fonts that come with text figures you can just ''add'' the method respectivefont feature to the set of [[http://wiki.contextgarden.net/Bibliography adding references in ConTexT]] is like bibtex in latex. Is there any simple methood like build-in latex method (\thebibliography)?: Perhaps [[http://wiki.contextgardenfont features.net/Simple_Bibliography Simple bibliography (in simple bibliography)]]?
=== XML: please tell me more about it ===<texcode>There is a section on the wiki dedicated to typesetting \definefontfeature[default][XMLdefault][onum=yes] under the various flavours of ConTeXt.
=== How do I make a presentation? ===\setupbodyfont[schola,8pt]
:You don't need any special package (like prosper or seminar in LaTeX) to make a presentation. In contrast to LaTeX, changing the document size, changing colors, adding hyperlinks, ... appears to be extremely simple in ConTeXt. See [[Presentations]] for more specific topics.\starttext1234567890\stoptext</texcode>
=== <code>\setupindenting[medium]</code> doesn't work? ===or
:This does work, but the effect is not what you expect. Without <code>yes</code>, you have now set up the default size, but you have not turned paragraph indenting on. You have to execute <codetexcode>\setupindentingsetupbodyfont[yesschola,8pt]</code> before it starts actually indenting your paragraphs.
\definefontfeature[oldstyle][onum=== Does $$...$$ work for display math, like in (La)TeX? ===:No; the spacing above and below the equation will be wrong, and maybe other aspects too. Instead use <cmd>startformula</cmd> and <cmd>stopformula</cmd> (just as one rather generally prefers to use <cmd>begin{equation}</cmd> and <cmd>end{equation}</cmd> in LaTeX).yes]
=== How do I get a numbered equation? ===\starttext1234567890 {\addff{oldstyle}1234567890}\stoptext:Add <cmd>placeformula</cmd> before the <cmd>startformula</cmdtexcode>.
=== How can I get a horizontal space with a defined width, so as exSee mailing list discussion at http://www.ntg. "\hspace{3em}" or "\hspace*{3em}" in LaTeX? ===:A horizontal space can be inserted with the TeXnl/pipermail/ntg-Primitive<cmd>hskip〈dimension〉<context/cmd> or with the ConTeXt command <cmd>hspace[identifier]<2011/cmd>058394.html .
=== How (You can I get check whether your font supports the lowercase (medieval, oldstyle figures) numbers in a document? ===“onum” feature by runningThe mediaeval numbers can be inserted locally by "\os". I would prefer a global setting of them but I don't know how to do it<code>otfinfo -f</code> on the OTF file.)
==Alignment = How transcribe this LaTeX macro to ConTEXt? ===Could you please advice me, how transcribe this macro, controlling that no last line of a paragraph is shorter than the paragraph indenting?
=== Why does <texcodecode>\parfillskip=\hsize\advance\parfillskip by -1.5\parindent\advance\parfillskip by 0pt minus \parfillskip\advance\parfillskip by 0pt minus -1emstartalignment[right]</texcodecodeLike this:or <texcodecode>\installalign framed[align=right]{blocksome text} {\parfillskip</code> align my text left instead of right and vice versa? ===\hsize \advance\parfillskip by -1.5\parindent \advance\parfillskip by 0pt minus \parfillskip \advance\parfillskip by 0pt minus -1em} % followed by\setupalign:This is for backward compatibility with older versions; see [[blockRight and left]]</texcode>. Hans was originally thinking of "ragged right" and "ragged left" alignment. Use '''flushleft''' and '''flushright''' instead.
=== Why is \framed{} not centred? ===
\stoptext
</texcode>
 
== Spacing ==
 
=== <code>\setupindenting[medium]</code> doesn't work? ===
:This does work, but the effect is not what you expect. Without <code>yes</code>, you have now set up the default size, but you have not turned paragraph indenting on. You have to execute <code>\setupindenting[yes]</code> before it starts actually indenting your paragraphs.
 
=== How can I get a horizontal space with a defined width, so as ex. "\hspace{3em}" or "\hspace*{3em}" in LaTeX? ===
:A horizontal space can be inserted with the TeX-Primitive <code>\hskip〈dimension〉</code> or with the ConTeXt command <cmd>hspace</cmd><tt>[identifier]</tt>.
=== Why is there a line-break in the output after some commands? ===
</texcode>
Answer: See previous answer!\externalfigure switches to vmode, so you need \dontleavehmode:
<texcode>
\starttext
</texcode>
==Math = Why = === Does $$...$$ work for display math, like in (La)TeX? ===:No; the spacing above and below the space is gobbled after some commandsequation will be wrong, and maybe other aspects too. Instead use <cmd>startformula</cmd> and <cmd>stopformula</cmd> (just as one rather generally prefers to use <cmd>begin{equation}</cmd> and <cmd>end{equation}</cmd> in LaTeX). === How do I get a numbered equation? ===:Add <texcodecmd>placeformula</cmd> before the <cmd>startformula</cmd>. == Misc == === Can I use some simpler bibliography method? ===\starttextX \externalfigureI see that the method of [[hackerhttp://wiki.contextgarden.net/Bibliography adding references in ConTexT][width=1cm] Xis like bibtex in latex. Is there any simple methood like build-in latex method (\stoptextthebibliography)?<: Perhaps [[http://wiki.contextgarden.net/texcode>Simple_Bibliography Simple bibliography (in simple bibliography)]]?
Answer: When you don't use all of the optional square bracket arguments,ConTeXt gobbles the space after the last square bracket. You have atleast 2 solutions:<texcode>\starttextX \externalfigure[hacker][width=1cm][] X % adding empty square brackets== How do I make a presentation? ===
X \externalfigure:You don't need any special package (like prosper or seminar in LaTeX) to make a presentation. In contrast to LaTeX, changing the document size, changing colors, adding hyperlinks, ... appears to be extremely simple in ConTeXt. See [[hackerPresentations][width=1cm]\ X % adding explicit space command\stoptext</texcode>for more specific topics.
148

edits

Navigation menu