https://wiki.contextgarden.net/api.php?action=feedcontributions&user=Mojca+Miklavec&feedformat=atomWiki - User contributions [en]2024-03-29T06:54:06ZUser contributionsMediaWiki 1.34.1https://wiki.contextgarden.net/index.php?title=Installation&diff=33550Installation2022-06-06T06:06:08Z<p>Mojca Miklavec: /* OpenBSD */ remove links to 32-bit version</p>
<hr />
<div>__NOTOC__<br />
Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[LMTX]]'''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).<br />
<br />
= Download =<br />
<br />
<ul id="DownloadRework"><br />
<br />
<li><br />
=== Windows ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== MacOS ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== GNU/Linux ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]<br />
* Musl [http://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl.zip 64b]<br />
</li><br />
<br />
<br />
<li><br />
<br />
=== FreeBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== OpenBSD ===<br />
* 7.0 [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0-amd64.zip 64b]<br />
* 7.1 [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1-amd64.zip 64b]<br />
</li><br />
</ul><br />
</li><br />
<br />
</ul><br />
<br />
</li><br />
</ul><br />
<br />
<br />
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).<br />
<br />
= Installation =<br />
<br />
The general steps to install ConTeXt LMTX are as follows:<br />
<br />
# Create a directory for ConTeXt.<br />
# Download the platform-specific archive file into the ConTeXt directory.<br />
# Unpack the archive.<br />
# Execute the install program, which downloads the distribution.<br />
# Update the PATH environment variable.<br />
# Optionally, delete the archive file.<br />
<br />
See the next sections for instructions specific to various platforms.<br />
<br />
== Unix ==<br />
<br />
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:<br />
<br />
# mkdir $HOME/context<br />
# cd $HOME/context<br />
# wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip<br />
# unzip context-linux-64.zip<br />
# sh install.sh<br />
<br />
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:<br />
<br />
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code><br />
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code><br />
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code><br />
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code><br />
<br />
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:<br />
<br />
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code><br />
<br />
== MacOS ==<br />
<br />
The instructions for MacOS are the same as for Unix, but note that:<br />
<br />
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.<br />
* MacOS versions before Catalina use '''Bash''' by default.<br />
<br />
== Windows ==<br />
<br />
Complete the following steps to set up ConTeXt on Windows:<br />
<br />
# Create a directory for ConTeXt, such as `C:\context`.<br />
# Download the architecture-specific version into the ConTeXt directory.<br />
# Extract the archive.<br />
# Run: <code>install.bat</code><br />
# Run: <code>setpath.bat</code><br />
<br />
Installation is complete.<br />
<br />
= First Run =<br />
<br />
This section describes how to run ConTeXt to transform your first TeX document into a PDF.<br />
<br />
# Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].<br />
# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).<br />
# Check the PDF output <code>Hello-world.pdf</code>.<br />
<br />
Additional tutorials include:<br />
<br />
* [[First Document| Your first document]]<br />
* [[Detailed Example|Detailed example]]<br />
<br />
See the [[Sample documents]] page for even more examples.<br />
<br />
= Upgrade =<br />
<br />
Re-run the install program to upgrade, which will update the distribution incrementally:<br />
<br />
* Windows: <code>install.bat</code><br />
* Unix: <code>sh install.sh</code><br />
<br />
= Running MkIV =<br />
<br />
The new distribution has all the files to run the previous version of ConTeXt. <br />
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].<br />
<br />
= Further installation instructions =<br />
<br />
* [[Installing ConTeXt LMTX on MacOS]]<br />
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]<br />
* The official page '''[http://www.pragma-ade.com/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.<br />
* Pragma ADE also provides the '''[http://www.pragma-ade.com/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].<br />
<br />
<br />
----<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Basics]]<br />
[[Category:Installation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Installation&diff=33526Installation2022-05-13T07:43:50Z<p>Mojca Miklavec: Reformat links to OpenBSD</p>
<hr />
<div>__NOTOC__<br />
Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[LMTX]]'''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).<br />
<br />
= Download =<br />
<br />
<ul id="DownloadRework"><br />
<br />
<li><br />
=== Windows ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== MacOS ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== GNU/Linux ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]<br />
* Musl [http://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl.zip 64b]<br />
</li><br />
<br />
<br />
<li><br />
<br />
=== FreeBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== OpenBSD ===<br />
* 7.0 [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0-amd64.zip 64b]<br />
* 7.1 [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1-amd64.zip 64b]<br />
</li><br />
</ul><br />
</li><br />
<br />
</ul><br />
<br />
</li><br />
</ul><br />
<br />
<br />
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).<br />
<br />
= Installation =<br />
<br />
The general steps to install ConTeXt LMTX are as follows:<br />
<br />
# Create a directory for ConTeXt.<br />
# Download the platform-specific archive file into the ConTeXt directory.<br />
# Unpack the archive.<br />
# Execute the install program, which downloads the distribution.<br />
# Update the PATH environment variable.<br />
# Optionally, delete the archive file.<br />
<br />
See the next sections for instructions specific to various platforms.<br />
<br />
== Unix ==<br />
<br />
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:<br />
<br />
# mkdir $HOME/context<br />
# cd $HOME/context<br />
# wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip<br />
# unzip context-linux-64.zip<br />
# sh install.sh<br />
<br />
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:<br />
<br />
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code><br />
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code><br />
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code><br />
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code><br />
<br />
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:<br />
<br />
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code><br />
<br />
== MacOS ==<br />
<br />
The instructions for MacOS are the same as for Unix, but note that:<br />
<br />
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.<br />
* MacOS versions before Catalina use '''Bash''' by default.<br />
<br />
== Windows ==<br />
<br />
Complete the following steps to set up ConTeXt on Windows:<br />
<br />
# Create a directory for ConTeXt, such as `C:\context`.<br />
# Download the architecture-specific version into the ConTeXt directory.<br />
# Extract the archive.<br />
# Run: <code>install.bat</code><br />
# Run: <code>setpath.bat</code><br />
<br />
Installation is complete.<br />
<br />
= First Run =<br />
<br />
This section describes how to run ConTeXt to transform your first TeX document into a PDF.<br />
<br />
# Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].<br />
# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).<br />
# Check the PDF output <code>Hello-world.pdf</code>.<br />
<br />
Additional tutorials include:<br />
<br />
* [[First Document| Your first document]]<br />
* [[Detailed Example|Detailed example]]<br />
<br />
See the [[Sample documents]] page for even more examples.<br />
<br />
= Upgrade =<br />
<br />
Re-run the install program to upgrade, which will update the distribution incrementally:<br />
<br />
* Windows: <code>install.bat</code><br />
* Unix: <code>sh install.sh</code><br />
<br />
= Running MkIV =<br />
<br />
The new distribution has all the files to run the previous version of ConTeXt. <br />
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].<br />
<br />
= Further installation instructions =<br />
<br />
* [[Installing ConTeXt LMTX on MacOS]]<br />
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]<br />
* The official page '''[http://www.pragma-ade.com/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.<br />
* Pragma ADE also provides the '''[http://www.pragma-ade.com/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].<br />
<br />
<br />
----<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Basics]]<br />
[[Category:Installation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Installation&diff=33525Installation2022-05-13T07:40:02Z<p>Mojca Miklavec: Add links to 32-bit OpenBSD binaries back</p>
<hr />
<div>__NOTOC__<br />
Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[LMTX]]'''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).<br />
<br />
= Download =<br />
<br />
<ul id="DownloadRework"><br />
<br />
<li><br />
=== Windows ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== MacOS ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== GNU/Linux ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]<br />
* Musl [http://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl.zip 64b]<br />
</li><br />
<br />
<br />
<li><br />
<br />
=== FreeBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== OpenBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0.zip 7.0, 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0-amd64.zip 7.0, 64bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1.zip 7.1, 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1-amd64.zip 7.1, 64bits]<br />
</li><br />
</ul><br />
</li><br />
<br />
</ul><br />
<br />
</li><br />
</ul><br />
<br />
<br />
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).<br />
<br />
= Installation =<br />
<br />
The general steps to install ConTeXt LMTX are as follows:<br />
<br />
# Create a directory for ConTeXt.<br />
# Download the platform-specific archive file into the ConTeXt directory.<br />
# Unpack the archive.<br />
# Execute the install program, which downloads the distribution.<br />
# Update the PATH environment variable.<br />
# Optionally, delete the archive file.<br />
<br />
See the next sections for instructions specific to various platforms.<br />
<br />
== Unix ==<br />
<br />
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:<br />
<br />
# mkdir $HOME/context<br />
# cd $HOME/context<br />
# wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip<br />
# unzip context-linux-64.zip<br />
# sh install.sh<br />
<br />
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:<br />
<br />
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code><br />
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code><br />
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code><br />
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code><br />
<br />
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:<br />
<br />
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code><br />
<br />
== MacOS ==<br />
<br />
The instructions for MacOS are the same as for Unix, but note that:<br />
<br />
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.<br />
* MacOS versions before Catalina use '''Bash''' by default.<br />
<br />
== Windows ==<br />
<br />
Complete the following steps to set up ConTeXt on Windows:<br />
<br />
# Create a directory for ConTeXt, such as `C:\context`.<br />
# Download the architecture-specific version into the ConTeXt directory.<br />
# Extract the archive.<br />
# Run: <code>install.bat</code><br />
# Run: <code>setpath.bat</code><br />
<br />
Installation is complete.<br />
<br />
= First Run =<br />
<br />
This section describes how to run ConTeXt to transform your first TeX document into a PDF.<br />
<br />
# Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].<br />
# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).<br />
# Check the PDF output <code>Hello-world.pdf</code>.<br />
<br />
Additional tutorials include:<br />
<br />
* [[First Document| Your first document]]<br />
* [[Detailed Example|Detailed example]]<br />
<br />
See the [[Sample documents]] page for even more examples.<br />
<br />
= Upgrade =<br />
<br />
Re-run the install program to upgrade, which will update the distribution incrementally:<br />
<br />
* Windows: <code>install.bat</code><br />
* Unix: <code>sh install.sh</code><br />
<br />
= Running MkIV =<br />
<br />
The new distribution has all the files to run the previous version of ConTeXt. <br />
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].<br />
<br />
= Further installation instructions =<br />
<br />
* [[Installing ConTeXt LMTX on MacOS]]<br />
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]<br />
* The official page '''[http://www.pragma-ade.com/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.<br />
* Pragma ADE also provides the '''[http://www.pragma-ade.com/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].<br />
<br />
<br />
----<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Basics]]<br />
[[Category:Installation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Installation&diff=33524Installation2022-05-13T06:58:36Z<p>Mojca Miklavec: Fix links to newer OpeBSD LMTX installers</p>
<hr />
<div>__NOTOC__<br />
Since April 2019, there is a new implementation of ConTeXt, named '''ConTeXt [[LMTX]]'''. It is tuned for LuaMetaTeX, the lean and mean successor of LuaTeX TeX engine (see [https://tug.org/TUGboat/tb40-1/tb124hagen-lmtx.pdf article]).<br />
<br />
= Download =<br />
<br />
<ul id="DownloadRework"><br />
<br />
<li><br />
=== Windows ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-mswin.zip 32bits]<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-win64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-windows-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== MacOS ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-64.zip 64bits]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-osx-arm64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== GNU/Linux ===<br />
* X86 [http://lmtx.pragma-ade.nl/install-lmtx/context-linux.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip 64b]<br />
* ARM [http://lmtx.pragma-ade.nl/install-lmtx/context-linux-armhf.zip 32b]|[http://lmtx.pragma-ade.nl/install-lmtx/context-linux-aarch64.zip 64b]<br />
* Musl [http://lmtx.pragma-ade.nl/install-lmtx/context-linuxmusl.zip 64b]<br />
</li><br />
<br />
<br />
<li><br />
<br />
=== FreeBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd.zip 32bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-freebsd-amd64.zip 64bits]<br />
</li><br />
<br />
<li><br />
<br />
=== OpenBSD ===<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.0-amd64.zip 7.0, 64bits]<br />
* [http://lmtx.pragma-ade.nl/install-lmtx/context-openbsd7.1-amd64.zip 7.1, 64bits]<br />
</li><br />
</ul><br />
</li><br />
<br />
</ul><br />
<br />
</li><br />
</ul><br />
<br />
<br />
You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, and Creative Commons Attribution ShareAlike for documentation).<br />
<br />
= Installation =<br />
<br />
The general steps to install ConTeXt LMTX are as follows:<br />
<br />
# Create a directory for ConTeXt.<br />
# Download the platform-specific archive file into the ConTeXt directory.<br />
# Unpack the archive.<br />
# Execute the install program, which downloads the distribution.<br />
# Update the PATH environment variable.<br />
# Optionally, delete the archive file.<br />
<br />
See the next sections for instructions specific to various platforms.<br />
<br />
== Unix ==<br />
<br />
The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands:<br />
<br />
# mkdir $HOME/context<br />
# cd $HOME/context<br />
# wget http://lmtx.pragma-ade.nl/install-lmtx/context-linux-64.zip<br />
# unzip context-linux-64.zip<br />
# sh install.sh<br />
<br />
Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:<br />
<br />
* '''Bash''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code><br />
* '''Zsh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code><br />
* '''Sh'''/'''Ksh''': <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code><br />
* '''Tcsh'''/'''csh''': <code>echo 'set path = ($path ...instructions...)' >> ~/.cshrc</code><br />
<br />
For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable:<br />
<br />
<code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bin:$PATH' >> ~/.bashrc</code><br />
<br />
== MacOS ==<br />
<br />
The instructions for MacOS are the same as for Unix, but note that:<br />
<br />
* MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.<br />
* MacOS versions before Catalina use '''Bash''' by default.<br />
<br />
== Windows ==<br />
<br />
Complete the following steps to set up ConTeXt on Windows:<br />
<br />
# Create a directory for ConTeXt, such as `C:\context`.<br />
# Download the architecture-specific version into the ConTeXt directory.<br />
# Extract the archive.<br />
# Run: <code>install.bat</code><br />
# Run: <code>setpath.bat</code><br />
<br />
Installation is complete.<br />
<br />
= First Run =<br />
<br />
This section describes how to run ConTeXt to transform your first TeX document into a PDF.<br />
<br />
# Download the tex input file [[Media:Hello-world.tex|Hello-World.tex]] from our [[Detailed_Example|Detailed example]].<br />
# Run <code>context Hello-world.tex</code> in your terminal (or command prompt).<br />
# Check the PDF output <code>Hello-world.pdf</code>.<br />
<br />
Additional tutorials include:<br />
<br />
* [[First Document| Your first document]]<br />
* [[Detailed Example|Detailed example]]<br />
<br />
See the [[Sample documents]] page for even more examples.<br />
<br />
= Upgrade =<br />
<br />
Re-run the install program to upgrade, which will update the distribution incrementally:<br />
<br />
* Windows: <code>install.bat</code><br />
* Unix: <code>sh install.sh</code><br />
<br />
= Running MkIV =<br />
<br />
The new distribution has all the files to run the previous version of ConTeXt. <br />
* Run <code>context --luatex Hello-world.tex</code> to use the `luatex` binary and [[MkIV]].<br />
<br />
= Further installation instructions =<br />
<br />
* [[Installing ConTeXt LMTX on MacOS]]<br />
* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]<br />
* The official page '''[http://www.pragma-ade.com/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.<br />
* Pragma ADE also provides the '''[http://www.pragma-ade.com/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].<br />
<br />
<br />
----<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Basics]]<br />
[[Category:Installation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone&diff=24062ConTeXt Standalone2019-01-30T20:35:02Z<p>Mojca Miklavec: Fix typo</p>
<hr />
<div>{{Installation navbox}}<br />
<br />
The '''ConTeXt suite''' is a complete, up-to-date ConTeXt distribution that can be upgraded efficiently. It can also be used in parallel with existing TeX installations such as MikTeX, TeXLive, and so forth. The suite does not include LaTeX packages and binaries.<br />
<br />
Sometimes ConTeXt beta releases have issues. The ConTeXt suite allows you to test the latest ConTeXt release without worrying whether upgrading will corrupt a critical project. Multiple ConTeXt suite installations are possible. This allows, for example, a stable version and a beta version to run in parallel on the same computer.<br />
<br />
ConTeXt is also included in TeXlive. The ConTeXt suite is updated continuously, whereas ConTeXt in TeXlive is updated less often. In particular, <code>luatex</code> and <code>metapost</code> are under active development and their binaries are updated frequently. ConTeXt follows these developments, indeed often drives development. As the binaries included in the TeXlive distribution are only updated yearly, ConTeXt on TeXlive will necessarily be less current than the ConTeXt suite. The ConTeXt suite is self-contained and can happily coexist alongside another installed TeX distribution.<br />
<br />
{{TOClimit|limit=1}}<br />
<br />
= General Information =<br />
<br />
== Supported platforms ==<br />
<br />
{| style="border:1px solid #DDDDDD;"<br />
|- align="left" <br />
! Platform<br />
! Short name<br />
! Notes<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Windows<br />
| mswin<br />
| from [http://w32tex.org W32TeX]<br />
|- align="left"<br />
! Linux, 32-bit<br />
| linux<br />
| Debian 8<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, 64-bit<br />
| linux-64<br />
| Debian 8<br />
|- align="left"<br />
! Linux, Arm (low end.)<br />
| linux-arm<br />
| Raspbian 8<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Intel (64-bit)<br />
| osx-64<br />
| Mac OS X 10.6<br />
|- align="left"<br />
! FreeBSD, 32-bit<br />
| freebsd<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! FreeBSD, 64-bit<br />
| freebsd-amd64<br />
|<br />
|- align="left"<br />
! OpenBSD 6.3, i386<br />
| openbsd6.3<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! OpenBSD 6.3, 64-bit<br />
| openbsd6.3-amd64<br />
|<br />
|- align="left"<br />
! OpenBSD 6.4, i386<br />
| openbsd6.4<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! OpenBSD 6.4, 64-bit<br />
| openbsd6.4-amd64<br />
|<br />
|- align="left"<br />
! Solaris, Intel<br />
| solaris-intel<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Solaris, Sparc<br />
| solaris-sparc<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|}<br />
<br />
*Note: we have stopped distributing binaries for kfreebsd. However, this system is still supported, and natively-compiled binaries can be installed from the Debian distribution.<br />
<br />
If you want to support a new platform, please write to the [[ConTeXt Mailing Lists]]<br />
<br />
== Dependencies ==<br />
* Rsync (The windows binary of rsync is distributed within the suite)<br />
<br />
<br />
The following programs are not required for running ConTeXt, but their installation adds additional functionality.<br />
<br />
* curl : for including remote content<br />
* ghostscript : for converting PostScript images to PDF<br />
* graphicsmagick (convert) : for converting GIF and TIFF images<br />
* inkscape : for converting SVG and compressed SVG<br />
* mupdf (mudraw) : for converting PDF to PNG (used for ePub covers)<br />
* pstoedit : for converting PostScript to MetaPost outlines<br />
* zint : for providing barcodes<br />
* zip or 7zip : for EPUB generation<br />
<br />
== Disc space required ==<br />
ConTeXt macro files are small (less than 10MB), but the suite comes with various free fonts which considerably increase the size of the distribution to around 200MB).<br />
<br />
== Multiple instances of the installation ==<br />
Please note from the start that we recommend installing a complete ConTeXt installation for each project in a production environment. The installation tree is portable (see Moving the Installation Around, below) and can be located under the project's own directory. The advantage is to allow each project to use an instance of ConTeXt that is adapted to its coding and that only gets updated purposely. Since the ConTeXt Standalone is "bleading edge" and subject to developement, certain details in commands, syntax or rendering may evolve slightly. Having a vintage ConTeXt tree for each production project insures that one can come back years later and produce identical results.<br />
<br />
So as not to get carried away under this approach, one can eventually group projects by vintage, period or season, according to cycles of productivity.<br />
<br />
== Standalone ==<br />
<br />
* [[ConTeXt Standalone/FAQ|Standalone/FAQ]] <br />
* [[ConTeXt Standalone/Structure|Standalone/Structure]] <br />
* [[ConTeXt Standalone/Implementation|Standalone/Implementation]]<br />
* [[ConTeXt Standalone/TODO|Standalone/TODO]] <br />
* [[ConTeXt Standalone/Contents|Standalone/Contents]] <br />
* [[ConTeXt Standalone/TeX Live|Standalone/TeX Live]]<br />
* Browse the [http://minimals.contextgarden.net installation tree]<br />
<br />
<br />
<br />
= Unix-like platforms (Linux/MacOS X/FreeBSD/Solaris) =<br />
<br />
For Mac installation see also [http://wiki.contextgarden.net/Mac_Installation Mac installation page].<br />
<br />
== Single user installation ==<br />
<br />
Select a folder where you want to install ConTeXt. We recommend that you can use your <code>$HOME/context</code> directory. Create this folder. Then download and place it in <code>$HOME/context</code> directory. Open a terminal, then:<br />
<br />
<pre><br />
mkdir ~/context<br />
cd ~/context<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== System-wide installation ==<br />
<br />
A system wide installation is recommended for users who are comfortable with the command line. Only the location of installing ConTeXt is different for a system wide installation.<br />
<br />
* on Linux you can use <code>/opt/context</code><br />
* on MacOS X you can use <code>/Applications/ConTeXt</code><br />
<br />
Note that, at present, while ''using'' MkIV, you need to have write permissions for the <code>$TEXMFCACHE</code> directory. This effectively means that only one user will be able to generate the formats unless you set the group permissions appropriately. For example:<br />
<br />
* <code>CONTEXT_HOME=/opt/context</code><br />
* <code>TEXMFCACHE=$CONTEXT_HOME/tex/texmf-cache</code><br />
* <code>chmod -R g+w $TEXMFCACHE</code><br />
<br />
<pre><br />
# Create the /opt/context directory -- change as appropriate or desired if you <br />
# want a different installation directory.<br />
cd /opt<br />
mkdir context<br />
<br />
cd context<br />
<br />
# Fetch the install script<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
<br />
# change ownership to real rather than effective id<br />
chown -R `id -r -u`:`id -r -g` .<br />
</pre><br />
<br />
===Cache===<br />
<br />
To customize the cache directory and other options, see the [[Custom_Configuration|Custom Configuration]] page.<br />
<br />
===Font Directory===<br />
<br />
Add the OSFONTDIR into ./tex/setuptex. Go to under the line:<br />
<br />
# TODO: we could set OSFONTDIR on Mac for example<br />
<br />
(if you don't have the line above, go to the end of the file) and add there:<br />
<br />
export OSFONTDIR="/usr/local/share/fonts;$HOME/.fonts"<br />
<br />
For more information: [[Fonts in LuaTeX]]<br />
<br />
== Apache webserver installation ==<br />
<br />
Another common usecase is invoking ConTeXt from within a web application. Because web directories are often self-contained, and in the case of Apache under Ubuntu, ownership of the directory and its contents are assigned to a user and group without a login shell, e.g., <code>www-data:www-data</code> this prevents a web application from invoking a ConTeXt installation done using either the single-user or system-wide method listed above.<br />
<br />
In this case the solution is to install ConTeXt within the website tree, and ideally in the public sub-tree. The public sub-tree is commonly the home directory for the application and relative pathnames are resolved as if immediately below it.<br />
<br />
For example, in the case of the PHP web framework Laravel, ConTeXt can be installed alongside other assets in the <path-to-document-root>/public/context directory:<br />
<br />
<pre><br />
cd <path-to-document-root>/public<br />
mkdir context<br />
cd context<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
Once installed, you need to ensure that the permissions are correct for Apache to be able to access it (you will either need <code>sudo</code> privileges or root access):<br />
<br />
<pre><br />
$ cd <path-to-document-root>/public<br />
$ sudo chmod -R www-data:www-data context<br />
</pre><br />
<br />
Now as part of your application's invocation of ConTeXt, you will need to set up the shell environment. This is easily done by creating a simple BASH shell script, also to be installed in the public part of the document tree:<br />
<br />
<pre><br />
#!/usr/bin/env bash<br />
<br />
#<br />
# proccontext.sh<br />
#<br />
# To be installed in <path-to-document-root>/public/bin<br />
<br />
. <path-to-document-root>/public/context/tex/setuptex <path-to-document-root>/public/context/tex<br />
<br />
cd tex/spool<br />
context $1 > /tmp/context_run.log<br />
</pre><br />
<br />
Here the dynamically generated ConTeXt source file is expected to be found in the <code><path-to-document-root>/tex/spool</code> directory.<br />
<br />
Now within your application, you can invoke this shell script (in this case using PHP):<br />
<br />
<pre><br />
$cmd = "bin/proccontext.sh $input_filename";<br />
$last_line = system($cmd, $ret_val);<br />
</pre><br />
<br />
And the output will once again be found in <code><path-to-document-root>/tex/spool</code>.<br />
<br />
==Arch Linux==<br />
There’s a [https://aur.archlinux.org/packages/context-minimals-git PKGBUILD] in<br />
the AUR, provided by Aditya [https://github.com/adityam/context-pkgbuild].<br />
Install it using your favorite AUR frontend, e.g.<br />
<br />
<pre><br />
yaourt -S context-minimals-git<br />
</pre><br />
<br />
This will get you a fresh, up-to-date Context tree in<br />
<tt>/opt/context-minimals</tt>.<br />
<br />
== The funtoo way ==<br />
<br />
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal or your startup script (<code>.bashrc</code> or the corresponding file for your shell). Replace username, password, proxyhost and proxyport with the correct information<br />
<br />
export RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
ConTeXt suite works in a non-interfering manner because it does not put anything in your <code>$PATH</code> and does not set any system variables. This in turn means that in order to use it, you need to do some initialization. An intialization script called <code>setuptex</code> is provided in <code>installation-dir/tex/</code>. <br />
<br />
=== Terminal/Command line ===<br />
<br />
To run context from a terminal, source <code>setuptex</code>:<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
=== Exclusive usage ===<br />
<br />
If you always use ConTeXt suite and '''never''' use LaTeX or plain TeX provided by another TeX distribution, you can add the following line to the startup script of your shell (For bash, the startup script is <code>$HOME/.bashrc</code>; for zsh it is <code>HOME/.zshrc</code>).<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
Then <code>setuptex</code> will always be sourced in your terminal.<br />
<br />
=== Integrating with an editor ===<br />
<br />
The easiest way to run ConTeXt from an editor is to open a terminal, source {{code|setuptex}} in the terminal, and then open your editor '''from the same terminal'''. <br />
<br />
Another option is to add {{code|/installation-dir/tex/texmf-<platform>/bin}} to the {{code|$PATH}} that the editor searches. The details vary depending on the editor. See [[Text Editors]] for instructions on integrating ConTeXt with various editors. <br />
<br />
For information about configuring [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Standalone/Mac Installation]].<br />
<br />
<br />
== Updating ==<br />
<br />
For updating the ConTeXt suite, <br />
first update <code>first-setup.sh</code>, then run it. You could<br />
also create an alias or a little script “ctx-update”<br />
with the following example contents:<br />
<pre><br />
cd /opt/context<br />
rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== Uninstalling ==<br />
<br />
ConTeXt suite does not touch anything outside its installation folder. So to uninstall it, you can simply remove the installation folder.<br />
<br />
== Remaking formats ==<br />
<br />
Normally, the update script should create the formats for you. If for some reason you need to recreate the formats, you can do the following:<br />
<br />
* For making MKII format.<br />
<br />
mktexlsr<br />
texexec --make --all <br />
<br />
* For making XeTeX format<br />
<br />
mktexlsr<br />
texexec --make --xtx --all <br />
<br />
* For making MKIV format<br />
<br />
mtxrun --generate<br />
context --make<br />
<br />
= Windows =<br />
<br />
If you want to use ConTeXt suite alongside MikTeX/TeXLive (needed if you also run LaTeX), follow the command-line installation method. <br />
<br />
== Installation ==<br />
<br />
=== Command line method ===<br />
Download [http://minimals.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] or [http://minimals.contextgarden.net/setup/context-setup-win64.zip context-setup-win64.zip], and unzip to a directory where you want to install ConTeXt. It is recommended that you choose a directory that does not have a space in its full path. Then open <code>cmd.exe</code>, go to the installation directory and run<br />
<br />
first-setup.bat<br />
<br />
This takes a long time, so go have a coffee. <br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use <br />
<br />
first-setup.bat --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
first-setup.bat --modules=all<br />
<br />
<br />
If the above installation instructions don't seem to answer your questions, see page [[Windows_Installation:_ConTeXt_Suite_with_SciTe| Windows Installation: ConTeXt Suite with SciTe]] for more detailed information.<br />
<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal as (replace username, password, proxyhost and proxyport with the correct information)<br />
<br />
set RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
or set the variable permanently as a Windows environment variable.<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
Before running ConTeXt, you need to run <code>setuptex.bat</code> which is provided in <code>installation-dir\tex\</code>. This can be done by typing<br />
<br />
installation-dir\tex\setuptex.bat<br />
<br />
on cmd.exe before you run ConTeXt. To avoid always having to type this, you can create a shortcut to cmd.exe and edit the command line to read (assuming you installed the suite in <code>C:\Programs</code>; otherwise replace <code>C:\Programs\</code> with your installation directory)<br />
<br />
C:\WINDOWS\System32\cmd.exe /k C:\Programs\context\tex\setuptex.bat<br />
<br />
This starts up a new command shell with the environment pre-loaded. Within the new shell you can just type <code>context</code> to run ConTeXt. E.g.<br />
<br />
C:\> context --version<br />
<br />
to check that you are running the version you think you're running.<br />
<br />
=== Use ConTeXt with Cygwin ===<br />
After installing the ConTeXt suite, you can run it under Cygwin. With Cygwin, you may use gmake and other Unix tools for your automated workflow.<br />
<br />
# Run <code>setuptex.bat</code> in DOS command prompt<br />
# In the same DOS prompt, enter Cygwin by running <code>cygwin.bat</code> (in your Cygwin installation directory)<br />
# Under Cygwin prompt, run <code> context.cmd test.tex </code>. Note that the <code>.cmd</code> extension is needed under Cygwin.<br />
<br />
== Updating ==<br />
<br />
If you used the command line method, just run <code>first-setup.bat</code> again to update the suite.<br />
<br />
<br />
== Uninstallation ==<br />
<br />
If you used the command-line installer, you can just delete the installation directory to uninstall the suite.<br />
<br />
<br />
== Troubleshooting ==<br />
<br />
* rsync sometimes has problems with paths with uppercase letters (like <code>c:\Temp</code> or <code>C:\Documents and Settings</code>). Installing into all-lowercase paths without spaces sometimes helps.<br />
* Directory-name length may also have an effect, due to Windows's 8.3 filename conventions. An indicator is if running "texexec --lua" on a file produces missing-file warnings containing Windows-created 8-character directory names, such as "C:\CONTEX~1\tex", where your ConTeXt directory is really "C:\context_minimals\tex". Be conservative and choose a short name like "C:\ctm\tex". Also, this may even work when an 8-character-or-less directory name like "C:\ctexmin\tex" doesn't.<br />
* If you're behind firewall and rsync times out, you need to open port 873 for outgoing TCP connections.<br />
* If you update luaTeX occasionally you may get something like <br />
<br />
<code>engine mismatch (luv: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2013/dev)(rev <number1>) <> bin: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2012/W32TeX)(rev <number2>)), forcing remake</code><br />
<br />
In which case your format will be remade every time you compile a file. In /texmf-mswin make sure that luatex.exe and texlua.exe have the same date; then also delete luatex.dll. This usually solves the problem.<br />
<br />
= Installing third party modules =<br />
<br />
The ConTeXt suite only comes with Taco's [[Bibliography|t-bib]] module. If you want to install [http://modules.contextgarden.net/ a new module], say Wolfgang's [[Letter|t-letter]] module, you can use<br />
first-setup.sh --modules="t-letter"<br />
<br />
If you want to install more than one extra module, you can separate them by commas. So, to install the t-letter and t-mathsets module, do<br />
sh ./first-setup.sh --modules="t-letter,t-mathsets"<br />
<br />
If you want to install all extra modules at once, do<br />
sh ./first-setup.sh --modules=all<br />
<br />
= Reverting to an older installation =<br />
<br />
If, for some reason, you want to revert to an older installation, you can do that by<br />
<br />
sh ./first-setup.sh --context=date<br />
<br />
where <code>date</code> is the date of one of the stable releases of ConTeXt. The complete list of old releases that are available is [http://minimals.contextgarden.net/current/context/ here].<br />
<br />
<br />
= Moving the installation tree around = <br />
<br />
According to this post, http://archive.contextgarden.net/message/20101129.144331.d721372f.en.html it's safe to move the installation tree across directory or machines (say you don't have broadband access). You just have to clean and regenerate the cache (./tex/texmf-cache/luatex-cache) with <br />
mtxrun --generate<br />
<br />
= Notes =<br />
<references/><br />
<br />
{{Getting started navbox}}<br />
[[Category:Installation]]<br />
[[Category:Standalone]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone&diff=24061ConTeXt Standalone2019-01-30T20:33:20Z<p>Mojca Miklavec: Revise the list of supported platforms</p>
<hr />
<div>{{Installation navbox}}<br />
<br />
The '''ConTeXt suite''' is a complete, up-to-date ConTeXt distribution that can be upgraded efficiently. It can also be used in parallel with existing TeX installations such as MikTeX, TeXLive, and so forth. The suite does not include LaTeX packages and binaries.<br />
<br />
Sometimes ConTeXt beta releases have issues. The ConTeXt suite allows you to test the latest ConTeXt release without worrying whether upgrading will corrupt a critical project. Multiple ConTeXt suite installations are possible. This allows, for example, a stable version and a beta version to run in parallel on the same computer.<br />
<br />
ConTeXt is also included in TeXlive. The ConTeXt suite is updated continuously, whereas ConTeXt in TeXlive is updated less often. In particular, <code>luatex</code> and <code>metapost</code> are under active development and their binaries are updated frequently. ConTeXt follows these developments, indeed often drives development. As the binaries included in the TeXlive distribution are only updated yearly, ConTeXt on TeXlive will necessarily be less current than the ConTeXt suite. The ConTeXt suite is self-contained and can happily coexist alongside another installed TeX distribution.<br />
<br />
{{TOClimit|limit=1}}<br />
<br />
= General Information =<br />
<br />
== Supported platforms ==<br />
<br />
{| style="border:1px solid #DDDDDD;"<br />
|- align="left" <br />
! Platform<br />
! Short name<br />
! Notes<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Windows<br />
| mswin<br />
| from [http://w32tex.org W32TeX]<br />
|- align="left"<br />
! Linux, 32-bit<br />
| linux<br />
| Debian 8<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, 64-bit<br />
| linux-64<br />
| Debian 8<br />
|- align="left""<br />
| Linux, Arm (low end.)<br />
| linux-arm<br />
| Raspbian 8<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Intel (64-bit)<br />
| osx-64<br />
| Mac OS X 10.6<br />
|- align="left"<br />
! FreeBSD, 32-bit<br />
| freebsd<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! FreeBSD, 64-bit<br />
| freebsd-amd64<br />
|<br />
|- align="left"<br />
! OpenBSD 6.3, i386<br />
| openbsd6.3<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! OpenBSD 6.3, 64-bit<br />
| openbsd6.3-amd64<br />
|<br />
|- align="left"<br />
! OpenBSD 6.4, i386<br />
| openbsd6.4<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! OpenBSD 6.4, 64-bit<br />
| openbsd6.4-amd64<br />
|<br />
|- align="left"<br />
! Solaris, Intel<br />
| solaris-intel<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Solaris, Sparc<br />
| solaris-sparc<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|}<br />
<br />
*Note: we have stopped distributing binaries for kfreebsd. However, this system is still supported, and natively-compiled binaries can be installed from the Debian distribution.<br />
<br />
If you want to support a new platform, please write to the [[ConTeXt Mailing Lists]]<br />
<br />
== Dependencies ==<br />
* Rsync (The windows binary of rsync is distributed within the suite)<br />
<br />
<br />
The following programs are not required for running ConTeXt, but their installation adds additional functionality.<br />
<br />
* curl : for including remote content<br />
* ghostscript : for converting PostScript images to PDF<br />
* graphicsmagick (convert) : for converting GIF and TIFF images<br />
* inkscape : for converting SVG and compressed SVG<br />
* mupdf (mudraw) : for converting PDF to PNG (used for ePub covers)<br />
* pstoedit : for converting PostScript to MetaPost outlines<br />
* zint : for providing barcodes<br />
* zip or 7zip : for EPUB generation<br />
<br />
== Disc space required ==<br />
ConTeXt macro files are small (less than 10MB), but the suite comes with various free fonts which considerably increase the size of the distribution to around 200MB).<br />
<br />
== Multiple instances of the installation ==<br />
Please note from the start that we recommend installing a complete ConTeXt installation for each project in a production environment. The installation tree is portable (see Moving the Installation Around, below) and can be located under the project's own directory. The advantage is to allow each project to use an instance of ConTeXt that is adapted to its coding and that only gets updated purposely. Since the ConTeXt Standalone is "bleading edge" and subject to developement, certain details in commands, syntax or rendering may evolve slightly. Having a vintage ConTeXt tree for each production project insures that one can come back years later and produce identical results.<br />
<br />
So as not to get carried away under this approach, one can eventually group projects by vintage, period or season, according to cycles of productivity.<br />
<br />
== Standalone ==<br />
<br />
* [[ConTeXt Standalone/FAQ|Standalone/FAQ]] <br />
* [[ConTeXt Standalone/Structure|Standalone/Structure]] <br />
* [[ConTeXt Standalone/Implementation|Standalone/Implementation]]<br />
* [[ConTeXt Standalone/TODO|Standalone/TODO]] <br />
* [[ConTeXt Standalone/Contents|Standalone/Contents]] <br />
* [[ConTeXt Standalone/TeX Live|Standalone/TeX Live]]<br />
* Browse the [http://minimals.contextgarden.net installation tree]<br />
<br />
<br />
<br />
= Unix-like platforms (Linux/MacOS X/FreeBSD/Solaris) =<br />
<br />
For Mac installation see also [http://wiki.contextgarden.net/Mac_Installation Mac installation page].<br />
<br />
== Single user installation ==<br />
<br />
Select a folder where you want to install ConTeXt. We recommend that you can use your <code>$HOME/context</code> directory. Create this folder. Then download and place it in <code>$HOME/context</code> directory. Open a terminal, then:<br />
<br />
<pre><br />
mkdir ~/context<br />
cd ~/context<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== System-wide installation ==<br />
<br />
A system wide installation is recommended for users who are comfortable with the command line. Only the location of installing ConTeXt is different for a system wide installation.<br />
<br />
* on Linux you can use <code>/opt/context</code><br />
* on MacOS X you can use <code>/Applications/ConTeXt</code><br />
<br />
Note that, at present, while ''using'' MkIV, you need to have write permissions for the <code>$TEXMFCACHE</code> directory. This effectively means that only one user will be able to generate the formats unless you set the group permissions appropriately. For example:<br />
<br />
* <code>CONTEXT_HOME=/opt/context</code><br />
* <code>TEXMFCACHE=$CONTEXT_HOME/tex/texmf-cache</code><br />
* <code>chmod -R g+w $TEXMFCACHE</code><br />
<br />
<pre><br />
# Create the /opt/context directory -- change as appropriate or desired if you <br />
# want a different installation directory.<br />
cd /opt<br />
mkdir context<br />
<br />
cd context<br />
<br />
# Fetch the install script<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
<br />
# change ownership to real rather than effective id<br />
chown -R `id -r -u`:`id -r -g` .<br />
</pre><br />
<br />
===Cache===<br />
<br />
To customize the cache directory and other options, see the [[Custom_Configuration|Custom Configuration]] page.<br />
<br />
===Font Directory===<br />
<br />
Add the OSFONTDIR into ./tex/setuptex. Go to under the line:<br />
<br />
# TODO: we could set OSFONTDIR on Mac for example<br />
<br />
(if you don't have the line above, go to the end of the file) and add there:<br />
<br />
export OSFONTDIR="/usr/local/share/fonts;$HOME/.fonts"<br />
<br />
For more information: [[Fonts in LuaTeX]]<br />
<br />
== Apache webserver installation ==<br />
<br />
Another common usecase is invoking ConTeXt from within a web application. Because web directories are often self-contained, and in the case of Apache under Ubuntu, ownership of the directory and its contents are assigned to a user and group without a login shell, e.g., <code>www-data:www-data</code> this prevents a web application from invoking a ConTeXt installation done using either the single-user or system-wide method listed above.<br />
<br />
In this case the solution is to install ConTeXt within the website tree, and ideally in the public sub-tree. The public sub-tree is commonly the home directory for the application and relative pathnames are resolved as if immediately below it.<br />
<br />
For example, in the case of the PHP web framework Laravel, ConTeXt can be installed alongside other assets in the <path-to-document-root>/public/context directory:<br />
<br />
<pre><br />
cd <path-to-document-root>/public<br />
mkdir context<br />
cd context<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
Once installed, you need to ensure that the permissions are correct for Apache to be able to access it (you will either need <code>sudo</code> privileges or root access):<br />
<br />
<pre><br />
$ cd <path-to-document-root>/public<br />
$ sudo chmod -R www-data:www-data context<br />
</pre><br />
<br />
Now as part of your application's invocation of ConTeXt, you will need to set up the shell environment. This is easily done by creating a simple BASH shell script, also to be installed in the public part of the document tree:<br />
<br />
<pre><br />
#!/usr/bin/env bash<br />
<br />
#<br />
# proccontext.sh<br />
#<br />
# To be installed in <path-to-document-root>/public/bin<br />
<br />
. <path-to-document-root>/public/context/tex/setuptex <path-to-document-root>/public/context/tex<br />
<br />
cd tex/spool<br />
context $1 > /tmp/context_run.log<br />
</pre><br />
<br />
Here the dynamically generated ConTeXt source file is expected to be found in the <code><path-to-document-root>/tex/spool</code> directory.<br />
<br />
Now within your application, you can invoke this shell script (in this case using PHP):<br />
<br />
<pre><br />
$cmd = "bin/proccontext.sh $input_filename";<br />
$last_line = system($cmd, $ret_val);<br />
</pre><br />
<br />
And the output will once again be found in <code><path-to-document-root>/tex/spool</code>.<br />
<br />
==Arch Linux==<br />
There’s a [https://aur.archlinux.org/packages/context-minimals-git PKGBUILD] in<br />
the AUR, provided by Aditya [https://github.com/adityam/context-pkgbuild].<br />
Install it using your favorite AUR frontend, e.g.<br />
<br />
<pre><br />
yaourt -S context-minimals-git<br />
</pre><br />
<br />
This will get you a fresh, up-to-date Context tree in<br />
<tt>/opt/context-minimals</tt>.<br />
<br />
== The funtoo way ==<br />
<br />
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal or your startup script (<code>.bashrc</code> or the corresponding file for your shell). Replace username, password, proxyhost and proxyport with the correct information<br />
<br />
export RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
ConTeXt suite works in a non-interfering manner because it does not put anything in your <code>$PATH</code> and does not set any system variables. This in turn means that in order to use it, you need to do some initialization. An intialization script called <code>setuptex</code> is provided in <code>installation-dir/tex/</code>. <br />
<br />
=== Terminal/Command line ===<br />
<br />
To run context from a terminal, source <code>setuptex</code>:<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
=== Exclusive usage ===<br />
<br />
If you always use ConTeXt suite and '''never''' use LaTeX or plain TeX provided by another TeX distribution, you can add the following line to the startup script of your shell (For bash, the startup script is <code>$HOME/.bashrc</code>; for zsh it is <code>HOME/.zshrc</code>).<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
Then <code>setuptex</code> will always be sourced in your terminal.<br />
<br />
=== Integrating with an editor ===<br />
<br />
The easiest way to run ConTeXt from an editor is to open a terminal, source {{code|setuptex}} in the terminal, and then open your editor '''from the same terminal'''. <br />
<br />
Another option is to add {{code|/installation-dir/tex/texmf-<platform>/bin}} to the {{code|$PATH}} that the editor searches. The details vary depending on the editor. See [[Text Editors]] for instructions on integrating ConTeXt with various editors. <br />
<br />
For information about configuring [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Standalone/Mac Installation]].<br />
<br />
<br />
== Updating ==<br />
<br />
For updating the ConTeXt suite, <br />
first update <code>first-setup.sh</code>, then run it. You could<br />
also create an alias or a little script “ctx-update”<br />
with the following example contents:<br />
<pre><br />
cd /opt/context<br />
rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== Uninstalling ==<br />
<br />
ConTeXt suite does not touch anything outside its installation folder. So to uninstall it, you can simply remove the installation folder.<br />
<br />
== Remaking formats ==<br />
<br />
Normally, the update script should create the formats for you. If for some reason you need to recreate the formats, you can do the following:<br />
<br />
* For making MKII format.<br />
<br />
mktexlsr<br />
texexec --make --all <br />
<br />
* For making XeTeX format<br />
<br />
mktexlsr<br />
texexec --make --xtx --all <br />
<br />
* For making MKIV format<br />
<br />
mtxrun --generate<br />
context --make<br />
<br />
= Windows =<br />
<br />
If you want to use ConTeXt suite alongside MikTeX/TeXLive (needed if you also run LaTeX), follow the command-line installation method. <br />
<br />
== Installation ==<br />
<br />
=== Command line method ===<br />
Download [http://minimals.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] or [http://minimals.contextgarden.net/setup/context-setup-win64.zip context-setup-win64.zip], and unzip to a directory where you want to install ConTeXt. It is recommended that you choose a directory that does not have a space in its full path. Then open <code>cmd.exe</code>, go to the installation directory and run<br />
<br />
first-setup.bat<br />
<br />
This takes a long time, so go have a coffee. <br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use <br />
<br />
first-setup.bat --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
first-setup.bat --modules=all<br />
<br />
<br />
If the above installation instructions don't seem to answer your questions, see page [[Windows_Installation:_ConTeXt_Suite_with_SciTe| Windows Installation: ConTeXt Suite with SciTe]] for more detailed information.<br />
<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal as (replace username, password, proxyhost and proxyport with the correct information)<br />
<br />
set RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
or set the variable permanently as a Windows environment variable.<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
Before running ConTeXt, you need to run <code>setuptex.bat</code> which is provided in <code>installation-dir\tex\</code>. This can be done by typing<br />
<br />
installation-dir\tex\setuptex.bat<br />
<br />
on cmd.exe before you run ConTeXt. To avoid always having to type this, you can create a shortcut to cmd.exe and edit the command line to read (assuming you installed the suite in <code>C:\Programs</code>; otherwise replace <code>C:\Programs\</code> with your installation directory)<br />
<br />
C:\WINDOWS\System32\cmd.exe /k C:\Programs\context\tex\setuptex.bat<br />
<br />
This starts up a new command shell with the environment pre-loaded. Within the new shell you can just type <code>context</code> to run ConTeXt. E.g.<br />
<br />
C:\> context --version<br />
<br />
to check that you are running the version you think you're running.<br />
<br />
=== Use ConTeXt with Cygwin ===<br />
After installing the ConTeXt suite, you can run it under Cygwin. With Cygwin, you may use gmake and other Unix tools for your automated workflow.<br />
<br />
# Run <code>setuptex.bat</code> in DOS command prompt<br />
# In the same DOS prompt, enter Cygwin by running <code>cygwin.bat</code> (in your Cygwin installation directory)<br />
# Under Cygwin prompt, run <code> context.cmd test.tex </code>. Note that the <code>.cmd</code> extension is needed under Cygwin.<br />
<br />
== Updating ==<br />
<br />
If you used the command line method, just run <code>first-setup.bat</code> again to update the suite.<br />
<br />
<br />
== Uninstallation ==<br />
<br />
If you used the command-line installer, you can just delete the installation directory to uninstall the suite.<br />
<br />
<br />
== Troubleshooting ==<br />
<br />
* rsync sometimes has problems with paths with uppercase letters (like <code>c:\Temp</code> or <code>C:\Documents and Settings</code>). Installing into all-lowercase paths without spaces sometimes helps.<br />
* Directory-name length may also have an effect, due to Windows's 8.3 filename conventions. An indicator is if running "texexec --lua" on a file produces missing-file warnings containing Windows-created 8-character directory names, such as "C:\CONTEX~1\tex", where your ConTeXt directory is really "C:\context_minimals\tex". Be conservative and choose a short name like "C:\ctm\tex". Also, this may even work when an 8-character-or-less directory name like "C:\ctexmin\tex" doesn't.<br />
* If you're behind firewall and rsync times out, you need to open port 873 for outgoing TCP connections.<br />
* If you update luaTeX occasionally you may get something like <br />
<br />
<code>engine mismatch (luv: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2013/dev)(rev <number1>) <> bin: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2012/W32TeX)(rev <number2>)), forcing remake</code><br />
<br />
In which case your format will be remade every time you compile a file. In /texmf-mswin make sure that luatex.exe and texlua.exe have the same date; then also delete luatex.dll. This usually solves the problem.<br />
<br />
= Installing third party modules =<br />
<br />
The ConTeXt suite only comes with Taco's [[Bibliography|t-bib]] module. If you want to install [http://modules.contextgarden.net/ a new module], say Wolfgang's [[Letter|t-letter]] module, you can use<br />
first-setup.sh --modules="t-letter"<br />
<br />
If you want to install more than one extra module, you can separate them by commas. So, to install the t-letter and t-mathsets module, do<br />
sh ./first-setup.sh --modules="t-letter,t-mathsets"<br />
<br />
If you want to install all extra modules at once, do<br />
sh ./first-setup.sh --modules=all<br />
<br />
= Reverting to an older installation =<br />
<br />
If, for some reason, you want to revert to an older installation, you can do that by<br />
<br />
sh ./first-setup.sh --context=date<br />
<br />
where <code>date</code> is the date of one of the stable releases of ConTeXt. The complete list of old releases that are available is [http://minimals.contextgarden.net/current/context/ here].<br />
<br />
<br />
= Moving the installation tree around = <br />
<br />
According to this post, http://archive.contextgarden.net/message/20101129.144331.d721372f.en.html it's safe to move the installation tree across directory or machines (say you don't have broadband access). You just have to clean and regenerate the cache (./tex/texmf-cache/luatex-cache) with <br />
mtxrun --generate<br />
<br />
= Notes =<br />
<references/><br />
<br />
{{Getting started navbox}}<br />
[[Category:Installation]]<br />
[[Category:Standalone]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Text_Editors&diff=23167Text Editors2016-10-25T16:03:50Z<p>Mojca Miklavec: add TextMate back to the list</p>
<hr />
<div>< [[Main Page]] | [[Related Programs]] ><br />
<br />
You can use any text editor for creating a source file for ConTeXt, even notepad should do. <br />
Many editors provide generic TeX syntax highlighting, but some have even more support for ConTeXt.<br />
<br />
== ConTeXt-aware ==<br />
<br />
<table> <tr style="background:#cccccc;"><br />
<td> Editor </td><br />
<td colspan="7"> features </td><br />
<td> Linux </td><br />
<td> Win </td><br />
<td> MacOS X </td><br />
<td> Remarks </td><br />
</tr> <tr style="background:#eeeeee;"><br />
<td> [http://www.emacswiki.org/cgi-bin/wiki Emacs] with [http://www.gnu.org/software/auctex/ AUCTeX] </td><br />
<td> </td><td> </td><td> S </td><td> T </td><td> U </td><td> </td><td> ? </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y </td><br />
<td> Extremely powerful & highly configurable text editor for CTRL- and ALT- key lovers.<br> The official AUCTeX distribution beginning with 11.50 has ConTeXt support. Berend de Boers ConTeXt mode for Emacs has been merged with the former ConTeXt support in AUCTeX by Patrick Gundlach. The [[AUCTeX]] page on this wiki has further AUCTeX customization for ConTeXt. If you write documents with bibliographies, indexes, or cross-references, you may also be interested in [[Reftex|using Reftex]]. There is also [[Emacs-muse]] which is an extension.</td><br />
</tr> <tr><br />
<td> [[Vim]] </td><br />
<td> </td><td> </td><td> S </td><td> T </td><td> U </td><td> 2 </td><td> ? </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y </td><br />
<td> Extremely powerful & highly configurable text editor. It operates in different "modes": you type in text in "insert mode" and pass commands to the editor in "normal mode." Whether you prefer Vim or emacs is a religious question of the highest importance.</td><br />
</tr> <tr style="background:#eeeeee;"><br />
<td>[[Scite]] or Textadept</td><br />
<td> C </td><td> </td><td> S </td><td> T </td><td> U </td><td> </td><td> </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y (TA only) </td><br />
<td> ConTeXt since v1.6.x. ConTeXt support files come with the ConTeXt distribution in directory context/data/context.properties. See also the [http://www.pragma-ade.com/general/manuals/mscite-s.pdf manual mcite.pdf]. </td><br />
</tr><tr><br />
<td> [http://www.uoregon.edu/~koch/texshop/ TeXshop] </td><br />
<td> ? </td><td> P </td><td> S </td><td> T </td><td> U </td><td> </td><td> </td><br />
<td> - </td><br />
<td> - </td><br />
<td> y (native)</td><br />
<td> Simple Cocoa IDE. [[ConTeXt_Minimals/Mac_Installation#TeXShop_installation_and_configuration|Configuration instructions]] </td><br />
</tr><tr style="background:#eeeeee;"><br />
<td>[http://www.tug.org/texworks/ TeXWorks]</td><br />
<td> </td><td> P </td><td> S </td><td> T </td><td> U </td><td> </td><td> </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y </td><br />
<td> Probably the most widespread TeX IDE, similar to TeXshop, supported by TUG. </td><br />
</tr><tr><br />
<td> [[TextMate]] </td><br />
<td> C </td><td> - </td><td> S </td><td> T </td><td> U </td><td> ? </td><td> </td><br />
<td> - </td><br />
<td> - </td><br />
<td> y (native)</td><br />
<td> The ConTeXt bundle is not yet in the distribution, but you can download a copy from [https://github.com/pgundlach/context.tmbundle/ GitHub]. </td><br />
</tr><tr style="background:#eeeeee;"><br />
<td> [[Notepad++]] </td><br />
<td> </td><td> </td><td>S </td><td>T </td><td>U </td><td>2 </td><td>+ </td><br />
<td> (Wine)</td><br />
<td>y </td><br />
<td> – </td><br />
<td> Npp is one of the most powerful and useful text editors around. For Windows users (you can also use it under Wine) wanting a more modern interface with loads of included features (see especially the TextFX menu), it deserves a close look. </td><br />
</tr><tr><br />
<td> [http://kate-editor.org Kate] </td><br />
<td> - </td><td> - </td><td> S </td><td> ? </td><td> U </td><td> - (KDE3) / 2 (KDE4) <td> + </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y </td><br />
<td> Kate is an advanced multi-document text editor for KDE (KWrite is in the same package, but handles only single documents). It has already built-in LaTeX syntax highlighting, but you can install a [http://kde-files.org/content/show.php/ConTeXt+-+Syntax+Highlighting?content=54006 file that provides ConTeXt syntax highlight]. It is planned to be included in the Kate package itself in the (near) future though.<br />
</tr> <br />
</table><br />
<br />
'''features:''' <br />
* C = TeX/ConTeXt command completion <br />
* P = PDF preview <br />
* S = TeX/ConTeXt syntax highlighting <br />
* T = ConTeXt typesetting<br />
* U = Unicode (UTF-8) handling<br />
* 2 = bidirectional edit (right-to-left)<br />
* + = more…<br />
* ? = previous feature probable but unsure<br />
<br />
== Other editors ==<br />
<br />
The following editors have no specific ConTeXt support, but do a good job for generic (La)TeX typesetting, so you may use them for ConTeXt as well:<br />
<table><br />
<tr style="background:#cccccc;"><br />
<td> Editor </td><br />
<td colspan="7"> features </td><br />
<td> Linux </td><br />
<td> Win </td><br />
<td> MacOS X </td><br />
<td> Remarks </td><br />
</tr><tr><br />
<td> [http://www.winedt.com/ WinEdt]</td><br />
<td> - </td><td> - </td><td> S </td><td> T </td><td> U </td><td> - </td><td> - </td><br />
<td> - </td><br />
<td> y </td><br />
<td> - </td><br />
<td> A nice, configurable Windows editor, very suitable for newbies to (La)TeX. A large collection of buttons with Greek letters and other (math) symbols is very helpfulp when typesetting math. It also has spell checker. LaTeX users can also find many templates (tables, enumerations, ...) and compiling/previewing the documents by clicking a button. This is supported for ConTeXt also. You can configure it easily. ''(WinEdt is not free software, but shareware with 31+ days trial. Discount for DANTE members.)''</td><br />
</tr><tr style="background:#eeeeee;"><br />
<td> [http://www.nano-editor.org/ GNU nano] </td><br />
<td> </td><br />
<td> </td><br />
<td> S </td><br />
<td> </td><br />
<td> U </td><br />
<td> ? </td><br />
<td> </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y </td><br />
<td> Curses-based text editor for Unix and Unix-like systems, designed to be a free replacement for the Pico text editor. Has basic TeX syntax highlighting. </td><br />
</tr><tr><br />
<td> [http://gedit.sourceforge.net/ gedit] </td><br />
<td> </td><br />
<td> </td><br />
<td> S </td><br />
<td> </td><br />
<td> U </td><br />
<td> ? </td><br />
<td> </td><br />
<td> y </td><br />
<td> y </td><br />
<td> y (X11) </td><br />
<td> GNOME editor </td><br />
</tr><tr style="background:#eeeeee;"><br />
<td> [http://www.textpad.com/ TextPad]</td><br />
<td> - </td><br />
<td> - </td><br />
<td> S </td><br />
<td> T </td><br />
<td> U </td><br />
<td> ? </td><br />
<td> + </td><br />
<td> - </td><br />
<td> y </td><br />
<td> - </td> <br />
<td> Commercial; TeX/ConTeXt/LaTeX command library; configurable to run a whatever-TeX command as a tool</td><br />
</tr><tr><br />
<td> [https://www.peterborgapps.com/smultron/ Smultron]</td><br />
<td> - </td><td> P </td><td> S </td><td> T </td><td> U </td><td> - </td><td> - </td><br />
<td> - </td><br />
<td> - </td><br />
<td> y </td><br />
<td> [[ConTeXt_Minimals/Mac_Installation#Smultron_installation_and_configuration|Old configuration instructions]]. Nowadays commercial. Old Open Source version was better. </td><br />
</tr><tr style="background:#eeeeee;"><br />
<td> [https://sourceforge.net/projects/nedit/ NEdit]</td><br />
<td> - </td><td> - </td><td> S </td><td> - </td><td> - </td><td> - </td><td> - </td><br />
<td> y </td><br />
<td> y </td><br />
<td> ? </td><br />
<td>X server (Cygwin/Xorg) is needed to run Nedit on Windows. Outdated.</td><br />
</tr> <br />
</table><br />
<br />
== SyncTeX ==<br />
<br />
For synchronising between text in PDF and TeX source see [[SyncTeX]].</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=SyncTeX&diff=22764SyncTeX2015-03-19T13:54:07Z<p>Mojca Miklavec: document \enabledirectives[system.synctex]</p>
<hr />
<div>'''SyncTeX''' is a program that puts a lot of anchors in the output file that link to the corresponding position in the source file. This allows you to quickly jump from PDF to source. <br />
<br />
== Usage ==<br />
<br />
You can use the <code>--synctex</code> switch to enable SyncTeX.<br />
<br />
So in MkIV you can run<br />
context --synctex <i>jobname</i><br />
and in MkII you can use<br />
texexec --synctex <i>jobname</i><br />
<br />
Alternatively you can add the following command to your MkIV document:<br />
<texcode><br />
\enabledirectives[system.synctex]<br />
</texcode><br />
<br />
This will create a file <code><i>jobname</i>.synctex.gz</code>. The command<br />
context --purge<br />
or next run without --synctex will remove the file again.<br />
<br />
This file can be used by your editor and PDF viewer to jump back and forth between the source and the PDF.<br />
<br />
== Editors & Viewers ==<br />
<br />
=== TeXWorks ===<br />
<br />
You may need to modify the command for executing ConTeXt first (you need to add <code>--synctex</code> switch in preferences).<br />
<br />
=== Evince ===<br />
Evince (the GNOME PDF viewer) supports SyncTeX since version 2.32.0.<br />
<br />
=== Skim.app & TextMate (Mac OS X) ===<br />
<br />
In Skim/Preferences/Sync choose TextMate. The key combination<br />
Shift + Apple + MouseClick<br />
will bring you to the corresponding line in text editor.<br />
<br />
In [[TextMate]] I have created my own command inside the ConTeXt bundle:<br />
<br />
* '''Save''': Nothing<br />
* '''Command(s)'''<br />
#!/bin/bash<br />
pdf=${TM_FILEPATH%tex}pdf<br />
/Applications/Skim.app/Contents/SharedSupport/displayline -r "$TM_LINE_NUMBER" "${pdf}"<br />
* '''Input''': None<br />
* '''Output''': Discard<br />
* '''Activation''': Key Equivalent (choose one; I used Ctrl+Alt+Apple+O)<br />
* '''Scope Selector''': text.tex.context<br />
<br />
If you use <code>Apple+R</code> for typesetting that needs to be modified as well (to account for --synctex switch).<br />
<br />
Hopefully this functionality will become part of the official ConTeXt bundle one day. (The recipe given above is too specific. The code needs to be written to handle more different viewers and different locations, not only a single viewer at a specified location.)<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Text Editors]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone&diff=22757ConTeXt Standalone2015-03-03T15:22:09Z<p>Mojca Miklavec: remove the suggestion to use --keep</p>
<hr />
<div>The '''ConTeXt suite''' is a complete, up-to-date ConTeXt distribution that can be upgraded efficiently. It can also be used in parallel with existing TeX installations such as MikTeX, TeXLive, and so forth. The suite does not include LaTeX packages and binaries.<br />
<br />
Sometimes ConTeXt beta releases have issues. The ConTeXt suite allows you to test the latest ConTeXt release without worrying whether upgrading will corrupt a critical project. Multiple ConTeXt suite installations are possible. This allows, for example, a stable version and a beta version to run in parallel on the same computer.<br />
<br />
ConTeXt is also included in TeXlive. The ConTeXt suite is updated continuously, whereas ConTeXt in TeXlive is updated less often. In particular, <code>luatex</code> and <code>metapost</code> are under active development and their binaries are updated frequently. ConTeXt follows these developments, indeed often drives development. As the binaries included in the TeXlive distribution are only updated yearly, ConTeXt on TeXlive will necessarily be less current than the ConTeXt suite. (ConTeXt on TeXlive can be kept somewhat more current using the http://tlcontrib.metatex.org repository.) The ConTeXt suite is self-contained and can happily coexist alongside another installed TeX distribution.<br />
<br />
{{TOClimit|limit=1}}<br />
<br />
= General Information =<br />
<br />
== Supported platforms ==<br />
<br />
{| style="border:1px solid #DDDDDD;"<br />
|- align="left" <br />
! Platform<br />
! Short name<br />
! Binaries by<br />
! Notes<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Windows<br />
| mswin<br />
| Akira Kakuto ([http://w32tex.org W32TeX])<br />
|<br />
|- align="left"<br />
! Linux<br />
| linux<br />
| Hans Hagen, Mojca Miklavec, Alan Braslau<br />
| compiled with glibc 2.3.6<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, 64-bit<br />
| linux-64<br />
| Alan Braslau<br />
|<br />
|- align="left"<br />
! Linux, PowerPC<br />
| linux-ppc<br />
| Piotr Kopszak<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, Arm (low end.)<br />
| linux-armel<br />
| Boris Veytsman<br />
| in progress<br />
|- align="left"<br />
! Mac OS X, Intel (32-bit)<br />
| osx-intel<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Intel (64-bit)<br />
| osx-64<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left"<br />
! Mac OS X, PowerPC<br />
| osx-ppc<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Universal Binaries<br />
| osx-universal<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left"<br />
! FreeBSD<br />
| freebsd<br />
| Alan Braslau<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! FreeBSD, 64-bit<br />
| freebsd-amd64<br />
| Alan Braslau<br />
| <br />
|- align="left"<br />
! kFreeBSD<br />
| kfreebsd-i386<br />
| Alan Braslau<br />
| FreeBSD + glibc (Debian)<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! kFreeBSD, 64-bit<br />
| kfreebsd-amd64<br />
| Alan Braslau<br />
| FreeBSD + glibc (Debian)<br />
|- align="left"<br />
! Solaris, Intel<br />
| solaris-intel<br />
| Marco Patzer<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Solaris, Sparc<br />
| solaris-sparc<br />
| Mojca Miklavec<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|}<br />
<br />
We need volunteers for providing binaries for other platforms. If you want to support a platform, please write to [[ConTeXt Mailing Lists]]<br />
<br />
== Dependencies ==<br />
* [http://www.ruby-lang.org Ruby] 1.8 or newer (used for MKII)<br />
* Rsync (The windows binary of rsync is distributed within the suite)<br />
<br />
<br />
The following programs are not required for running ConTeXt, but their installation adds additional functionality.<br />
<br />
* curl : for including remote content<br />
* ghostscript : for converting PostScript images to PDF<br />
* graphicsmagick (convert) : for converting GIF and TIFF images<br />
* inkscape : for converting SVG and compressed SVG<br />
* mupdf (mudraw) : for converting PDF to PNG (used for ePub covers)<br />
* pstoedit : for converting PostScript to MetaPost outlines<br />
* zint : for providing barcodes<br />
* zip or 7zip : for EPUB generation<br />
<br />
== Disc space required ==<br />
ConTeXt macro files are small (less than 10MB), but the suite comes with various free fonts which considerably increase the size of the distribution to around 200MB).<br />
<br />
== Standalone ==<br />
<br />
* [[ConTeXt Standalone/FAQ|Standalone/FAQ]] <br />
* [[ConTeXt Standalone/Structure|Standalone/Structure]] <br />
* [[ConTeXt Standalone/Implementation|Standalone/Implementation]]<br />
* [[ConTeXt Standalone/TODO|Standalone/TODO]] <br />
* [[ConTeXt Standalone/Contents|Standalone/Contents]] <br />
* [[ConTeXt Standalone/TeX Live|Standalone/TeX Live]]<br />
* Browse the [http://minimals.contextgarden.net installation tree]<br />
<br />
<br />
<br />
= Unix-like platforms (Linux/MacOS X/FreeBSD/Solaris) =<br />
<br />
For Mac installation see also [http://wiki.contextgarden.net/Mac_Installation Mac installation page].<br />
<br />
== Single user installation ==<br />
<br />
Select a folder where you want to install ConTeXt. We recommend that you can use your <code>$HOME/context</code> directory. Create this folder. Then download and place it in <code>$HOME/context</code> directory. Open a terminal, then:<br />
<br />
<pre><br />
mkdir ~/context<br />
cd ~/context<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== System-wide installation ==<br />
<br />
A system wide installation is recommended for users who are comfortable with the command line. Only the location of installing ConTeXt is different for a system wide installation.<br />
<br />
* on Linux you can use <code>/opt/context</code><br />
* on MacOS X you can use <code>/Applications/ConTeXt</code><br />
<br />
Note that, at present, while ''using'' MkIV, you need to have write permissions for the <code>$TEXMFCACHE</code> directory. This effectively means that only one user will be able to generate the formats.<br />
<br />
<pre><br />
# Create the /opt/context directory -- change as appropriate or desired if you <br />
# want a different installation directory.<br />
cd /opt<br />
mkdir context<br />
<br />
# change ownership<br />
chown `whoami`:`whoami` context<br />
cd context<br />
<br />
# Fetch the install script<br />
wget http://minimals.contextgarden.net/setup/first-setup.sh<br />
<br />
# Install the latest beta of ConTeXt<br />
# This takes a long time, so go have a coffee<br />
# Flags you can add to the first-setup.sh call:<br />
# --modules=all # Install all third-party modules<br />
# --context=current # Install latest stable version<br />
# --engine=luatex # Install only MkIV, leave out MkII<br />
# # This shrinks the install from 270 MB to 200 MB<br />
<br />
sh ./first-setup.sh --modules=all<br />
<br />
</pre><br />
<br />
===Cache===<br />
<br />
To customize the cache directory and other options, see the [[Custom_Configuration|Custom Configuration]] page.<br />
<br />
===Font Directory===<br />
<br />
Add the OSOFONTDIR into ./tex/setuptex. Go to under the line:<br />
<br />
# TODO: we could set OSFONTDIR on Mac for example<br />
<br />
(if you don't have the line above, go to the end of the file) and add there:<br />
<br />
export OSFONTDIR="/usr/local/share/fonts;$HOME/.fonts"<br />
<br />
For more information: [[Fonts in LuaTeX]]<br />
<br />
==Arch Linux==<br />
There’s a [http://aur.archlinux.org/packages.php?ID=30398 PKGBUILD] in<br />
the AUR, provided by Aditya [https://github.com/adityam/context-pkgbuild].<br />
Install it using your favorite AUR frontend, e.g.<br />
<br />
<pre><br />
yaourt -S context-minimals-git<br />
</pre><br />
<br />
This will get you a fresh, up-to-date Context tree in<br />
<tt>/opt/context-minimals</tt>.<br />
<br />
== The funtoo way ==<br />
<br />
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal or your startup script (<code>.bashrc</code> or the corresponding file for your shell). Replace username, password, proxyhost and proxyport with the correct information<br />
<br />
export RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
ConTeXt suite works in a non-interfering manner because it does not put anything in your <code>$PATH</code> and does not set any system variables. This in turn means that in order to use it, you need to do some initialization. An intialization script called <code>setuptex</code> is provided in <code>installation-dir/tex/</code>. <br />
<br />
=== Terminal/Command line ===<br />
<br />
To run context from a terminal, source <code>setuptex</code>:<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
=== Exclusive usage ===<br />
<br />
If you always use ConTeXt suite and '''never''' use LaTeX or plain TeX provided by another TeX distribution, you can add the following line to the startup script of your shell (For bash, the startup script is <code>$HOME/.bashrc</code>; for zsh it is <code>HOME/.zshrc</code>).<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
Then <code>setuptex</code> will always be sourced in your terminal.<br />
<br />
=== Integrating with an editor ===<br />
<br />
The easiest way to run ConTeXt from an editor is to open a terminal, source {{code|setuptex}} in the terminal, and then open your editor '''from the same terminal'''. <br />
<br />
Another option is to add {{code|/installation-dir/tex/texmf-<platform>/bin}} to the {{code|$PATH}} that the editor searches. The details vary depending on the editor. See [[Text Editors]] for instructions on integrating ConTeXt with various editors. <br />
<br />
For information about configuring [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Standalone/Mac Installation]].<br />
<br />
<br />
== Updating ==<br />
<br />
For updating the ConTeXt suite, <br />
first update <code>first-setup.sh</code>, then run it. You could<br />
also create an alias or a little script “ctx-update”<br />
with the following example contents:<br />
<pre><br />
cd /opt/context<br />
rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .<br />
sh ./first-setup.sh --modules=all<br />
</pre><br />
<br />
== Uninstalling ==<br />
<br />
ConTeXt suite does not touch anything outside its installation folder. So to uninstall it, you can simply remove the installation folder.<br />
<br />
== Remaking formats ==<br />
<br />
Normally, the update script should create the formats for you. If for some reason you need to recreate the formats, you can do the following:<br />
<br />
* For making MKII format.<br />
<br />
mktexlsr<br />
texexec --make --all <br />
<br />
* For making XeTeX format<br />
<br />
mktexlsr<br />
texexec --make --xtx --all <br />
<br />
* For making MKIV format<br />
<br />
mtxrun --generate<br />
context --make<br />
<br />
= Windows =<br />
<br />
If you want to use ConTeXt suite alongside MikTeX/TeXLive (needed if you also run LaTeX), follow the command-line installation method. <br />
<br />
== Installation ==<br />
<br />
=== Command line method ===<br />
Download [http://minimals.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] or [http://minimals.contextgarden.net/setup/context-setup-win64.zip context-setup-win64.zip], and unzip to a directory where you want to install ConTeXt. It is recommended that you choose a directory that does not have a space in its full path. Then open <code>cmd.exe</code>, go to the installation directory and run<br />
<br />
first-setup.bat<br />
<br />
This takes a long time, so go have a coffee. <br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use <br />
<br />
first-setup.bat --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
first-setup.bat --modules=all<br />
<br />
<br />
If the above installation instructions don't seem to answer your questions, see page [[Windows_Installation:_ConTeXt_Suite_with_SciTe| Windows Installation: ConTeXt Suite with SciTe]] for more detailed information.<br />
<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal as (replace username, password, proxyhost and proxyport with the correct information)<br />
<br />
set RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
or set the variable permanently as a Windows environment variable.<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
Before running ConTeXt, you need to run <code>setuptex.bat</code> which is provided in <code>installation-dir\tex\</code>. This can be done by typing<br />
<br />
installation-dir\tex\setuptex.bat<br />
<br />
on cmd.exe before you run ConTeXt. To avoid always having to type this, you can create a shortcut to cmd.exe and edit the command line to read (assuming you installed the suite in <code>C:\Programs</code>; otherwise replace <code>C:\Programs\</code> with your installation directory)<br />
<br />
C:\WINDOWS\System32\cmd.exe /k C:\Programs\context\tex\setuptex.bat<br />
<br />
This starts up a new command shell with the environment pre-loaded. Within the new shell you can just type <code>context</code> to run ConTeXt. E.g.<br />
<br />
C:\> context --version<br />
<br />
to check that you are running the version you think you're running.<br />
<br />
=== Use ConTeXt with Cygwin ===<br />
After installing the ConTeXt suite, you can run it under Cygwin. With Cygwin, you may use gmake and other Unix tools for your automated workflow.<br />
<br />
# Run <code>setuptex.bat</code> in DOS command prompt<br />
# In the same DOS prompt, enter Cygwin by running <code>cygwin.bat</code> (in your Cygwin installation directory)<br />
# Under Cygwin prompt, run <code> context.cmd test.tex </code>. Note that the <code>.cmd</code> extension is needed under Cygwin.<br />
<br />
== Updating ==<br />
<br />
If you used the command line method, just run <code>first-setup.bat</code> again to update the suite.<br />
<br />
<br />
== Uninstallation ==<br />
<br />
If you used the command-line installer, you can just delete the installation directory to uninstall the suite.<br />
<br />
<br />
== Troubleshooting ==<br />
<br />
* rsync sometimes has problems with paths with uppercase letters (like <code>c:\Temp</code> or <code>C:\Documents and Settings</code>). Installing into all-lowercase paths without spaces sometimes helps.<br />
* Directory-name length may also have an effect, due to Windows's 8.3 filename conventions. An indicator is if running "texexec --lua" on a file produces missing-file warnings containing Windows-created 8-character directory names, such as "C:\CONTEX~1\tex", where your ConTeXt directory is really "C:\context_minimals\tex". Be conservative and choose a short name like "C:\ctm\tex". Also, this may even work when an 8-character-or-less directory name like "C:\ctexmin\tex" doesn't.<br />
* If you're behind firewall and rsync times out, you need to open port 873 for outgoing TCP connections.<br />
* If you update luaTeX occasionally you may get something like <br />
<br />
<code>engine mismatch (luv: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2013/dev)(rev <number1>) <> bin: This is LuaTeX, Version beta-<version>-<date1> (TeX Live 2012/W32TeX)(rev <number2>)), forcing remake</code><br />
<br />
In which case your format will be remade every time you compile a file. In /texmf-mswin make sure that luatex.exe and texlua.exe have the same date; then also delete luatex.dll. This usually solves the problem.<br />
<br />
= Installing third party modules =<br />
<br />
The ConTeXt suite only comes with Taco's [[Bibliography|t-bib]] module. If you want to install [http://modules.contextgarden.net/ a new module], say Wolfgang's [[Letter|t-letter]] module, you can use<br />
first-setup.sh --modules="t-letter"<br />
<br />
If you want to install more than one extra module, you can separate them by commas. So, to install the t-letter and t-mathsets module, do<br />
sh ./first-setup.sh --modules="t-letter,t-mathsets"<br />
<br />
If you want to install all extra modules at once, do<br />
sh ./first-setup.sh --modules=all<br />
<br />
= Reverting to an older installation =<br />
<br />
If, for some reason, you want to revert to an older installation, you can do that by<br />
<br />
sh ./first-setup.sh --context=date<br />
<br />
where <code>date</code> is the date of one of the stable releases of ConTeXt. The complete list of old releases that are available is [http://minimals.contextgarden.net/current/context/ here].<br />
<br />
<br />
= Moving the installation tree around = <br />
<br />
According to this post, http://archive.contextgarden.net/message/20101129.144331.d721372f.en.html it's safe to move the installation tree across directory or machines (say you don't have broadband access). You just have to clean and regenerate the cache (./tex/texmf-cache/luatex-cache) with <br />
mtxrun --generate<br />
<br />
= Notes =<br />
<references/><br />
<br />
{{Installation navbox}}<br />
{{Getting started navbox}}<br />
[[Category:Installation]]<br />
[[Category:Standalone]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=TikZ&diff=22756TikZ2015-03-03T13:04:10Z<p>Mojca Miklavec: remove link to modules.contextgarden.net</p>
<hr />
<div>< [[Modules]] | [[Graphics]] > <br />
<br />
[http://pgf.sourceforge.net/ TikZ/pgf] is a portable graphics package developed for LaTeX,<br />
also supporting ConTeXt. It is a possible alternative to [[MetaPost]] & [[MetaFun]]. <br />
<br />
TikZ is included as a (third party) module for ConTeXt.<br />
<br />
== Example ==<br />
<br />
From the TikZ/pgf [http://dl.contextgarden.net/modules/t-tikz/doc/generic/pgf/pgfmanual.pdf manual].<br />
<br />
<texcode><br />
\setupcolors[state=start]<br />
\definecolor[darkgreen][g=.5]<br />
\usemodule[tikz] <br />
<br />
\starttext<br />
<br />
\starttikzpicture[ scale=3,line cap=round<br />
axes/.style=, <br />
important line/.style={very thick},<br />
information text/.style={rounded corners,fill=red!10,inner sep=1ex} ]<br />
<br />
\draw[help lines,step=0.5cm] (-1.4,-1.4) grid (1.4,1.4);<br />
\draw (0,0) circle (1cm); <br />
\draw[->] (-1.5,0) -- (1.5,0) node[right] {$x$} coordinate(x axis);<br />
\draw[->] (0,-1.5) -- (0,1.5) node[above] {$y$} coordinate(y axis);<br />
\foreach \x/\xtext in {-1, -.5/-\frac{1}{2}, 1} <br />
\draw[xshift=\x cm] (0pt,1pt) -- (0pt,-1pt) <br />
node[below,fill=white] {$\xtext$};<br />
\foreach \y/\ytext in {-1, -.5/-\frac{1}{2}, .5/\frac{1}{2}, 1}<br />
\draw[yshift=\y cm] (1pt,0pt) -- (-1pt,0pt)<br />
node[left,fill=white] {$\ytext$};<br />
\filldraw[fill=green!20,draw=green!50!black] (0,0) -- (3mm,0pt) arc(0:30:3mm);<br />
\draw (15:2mm) node[green!50!black] {$\alpha$};<br />
\draw[important line,red]<br />
(30:1cm) -- node[left=1pt,fill=white] {$\sin \alpha$} (30:1cm |- x axis);<br />
\draw[important line,blue]<br />
(30:1cm |- x axis) -- node[below=2pt,fill=white] {$\cos \alpha$} (0,0);<br />
\draw[important line,orange!80!black] (1,0) -- node[right=1pt,fill=white] {<br />
$\displaystyle \tan \alpha \black =<br />
\frac{{\red \sin \alpha}}{\blue \cos \alpha}$}<br />
(intersection of 0,0--30:1cm and 1,0--1,1) coordinate (t);<br />
\draw (0,0) -- (t);<br />
\draw[xshift=1.85cm]<br />
node[right,text width=6cm,information text]<br />
{<br />
The {\darkgreen angle $\alpha$} is $30^\circ$ in the<br />
example ($\pi/6$ in radians). The {\red sine of<br />
$\alpha$}, which is the height of the red line, is<br />
\startformula<br />
{\red \sin \alpha} = 1/2.<br />
\stopformula<br />
By the Theorem of Pythagoras ...<br />
};<br />
\stoptikzpicture<br />
<br />
\stoptext<br />
</texcode><br />
<br />
[[Image:TikZ_example.png]]<br />
<br />
== Placing TikZ graphics ==<br />
<br />
You should wrap TikZ graphics inside \hbox when placing them, for example:<br />
<br />
<texcode><br />
<br />
\placefigure[here][fig:myfig]{My figure.}{\hbox{\starttikzpicture<br />
\draw (0, 0) circle (3cm);<br />
\stoptikzpicture}}<br />
<br />
</texcode><br />
<br />
Otherwise, positioning will not work (figure will not be centered). See [http://www.ntg.nl/pipermail/ntg-context/2007/023177.html this post] by Aditya Mahajan for explanation.<br />
<br />
== See also ==<br />
<br />
[http://archive.contextgarden.net/message/20080219.024326.0e45446b.pt.html Discussion] on the ConTeXt user's list.<br />
<br />
[[Category:Modules]]<br />
[[Category:Graphics]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone/Implementation&diff=22701ConTeXt Standalone/Implementation2014-12-13T13:12:44Z<p>Mojca Miklavec: fix links to metapost</p>
<hr />
<div>< [[ConTeXt Standalone]] | [[ConTeXt Standalone/Structure]] ><br />
<br />
<br />
Binaries can now be built from<br />
svn co http://svn.contextgarden.net/suite/build-binaries<br />
It might take some time to propagate the changes and auto-update this page :)<br />
<br />
== Binary sources ==<br />
<br />
We take binaries from the following sources:<br />
<br />
=== MetaPost ===<br />
* SVN: https://foundry.supelec.fr/svn/metapost<br />
* ViewVC: https://foundry.supelec.fr/scm/viewvc.php/?root=metapost<br />
* files: http://foundry.supelec.fr/gf/project/metapost/frs/<br />
<code>tags/XXX</code><br />
<br />
=== LuaTeX ===<br />
* SVN: https://foundry.supelec.fr/svn/luatex<br />
* ViewVC: https://foundry.supelec.fr/scm/viewvc.php/?root=luatex<br />
* Files: http://foundry.supelec.fr/gf/project/luatex/frs/<br />
<code>tags/beta-XXX</code><br />
<br />
=== W32TeX ===<br />
<br />
* http://w32tex.org<br />
<br />
=== TeX Live 2012 ===<br />
<br />
* http://www.tug.org/texlive/svn/<br />
<br />
=== Others (not used any more) ===<br />
<br />
We also used to compile pdfTeX and XeTeX, but stopped doing so as there was no need to use a version newer than what's in TeX Live.<br />
<br />
==== pdfTeX ====<br />
* SVN: http://foundry.supelec.fr/svn/pdftex<br />
* VieVC: http://foundry.supelec.fr/gf/project/pdftex/scmsvn/<br />
<code>branches/stable/source</code><br />
<br />
==== XeTeX ====<br />
* GIT: git://git.code.sf.net/p/xetex/code<br />
* Gitweb: http://xetex.git.sourceforge.net/<br />
<code>master</code><br />
<br />
== rsync ==<br />
<br />
Rsync on Windows behaves a bit weird. We fetched binaries from<br />
* http://www.itefix.no/cwrsync/<br />
One needs to set<br />
set CYGWIN=noNTsec<br />
before syncing binaries or<br />
chmod 777 tex/texmf-win/bin/*<br />
after that, else binaries won't work.<br />
<br />
From rsync bundle one needs to have at least<br />
chmod.exe<br />
cygiconv-2.dll # for chmod<br />
cygintl-3.dll # for chmod<br />
cygwin1.dll<br />
rsync.exe<br />
to be able to use rsync from the garden properly. I have no idea what happens if cygwin is in PATH, but it is asking for problems.<br />
<br />
<br />
<br />
== Cross-compiling on Mac OS X ==<br />
<br />
In order to cross-compile for PPC on a Intel Mac, you need to give the compiler and the linker the following additional switches:<br />
<br />
-arch ppc<br />
<br />
So all you have to do is set <code>CFLAGS</code> and <code>LDFLAGS</code> before you run <code>configure</code> (as well as <code>CXXFLAGS</code>, if applicable). Of course it may be that some Makefiles don't honor these variables and override them with something of their own, and this is the major inconvience you will have to deal with (this is actually what the Makefile for lua does; here you would have to set something like <code>MYCFLAGS</code> or <code>XCFLAGS</code> in addition).<br />
<br />
Obviously, you can also use a similar instruction to cross-compile the other way round (build for Intel on a PPC host); it's called <code>-arch i386</code>; and if you give both at the same time, it results with a so-called ''universal'' binary (the size of which being approximately the sum of the size of both individual binaries). [[User:Arthur|Arthur]] 17:20, 30 September 2007 (CEST)<br />
<br />
For pdfTeX it's enough to say<br />
CFLAGS="-arch ppc" LDFLAGS="-arch ppc" CXXFLAGS="-arch ppc" ./build.sh<br />
<br />
XeTeX supports the syntax<br />
./build-xetex "-arch ppc"<br />
for cross-compiling.<br />
<br />
It is also adviced to use<br />
gcc_select<br />
and select gcc 3.3 to be more backward compatible, as well as setting<br />
export MACOSX_DEPLOYMENT_TARGET=10.3<br />
<br />
== Compiling TeX Live binaries ==<br />
<br />
To compile 64-bit binaries on 10.6 or later:<br />
./Build --disable-xdvipdfmx --disable-xetex --disable-xdv2pdf<br />
To select the latest compiler on Lion:<br />
CC=clang OBJC=clang CXX=clang++ ./Build <options><br />
If we want to compile for 10.6 on 10.7 we additionally need:<br />
export MACOSX_DEPLOYMENT_TARGET=10.6<br />
# or add -mmacosx-version-min=10.6 to CFLAGS<br />
# most of the time optional; usually not needed, but one never knows<br />
export MYCFLAGS='-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk'<br />
export CC=llvm-gcc-4.2; export CFLAGS=$MYCFLAGS<br />
export OBJC=llvm-gcc-4.2; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=llvm-g++-4.2; export CXXFLAGS=$MYCFLAGS<br />
./Build <options><br />
<br />
To compile ppc and i386 binaries for Tiger on 10.6:<br />
export ARCH=i386<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-arch $ARCH -isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export LDFLAGS='-arch $ARCH'<br />
export CC=gcc-4.0; export CFLAGS=$MYCFLAGS<br />
export OBJC=gcc-4.0; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=g++-4.0; export CXXFLAGS=$MYCFLAGS<br />
<br />
Or alternatively:<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=i686-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=i686-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=i686-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=powerpc-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=powerpc-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=powerpc-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
= Non-Polish Fonts =<br />
<br />
== List of fonts in the old minimals ==<br />
<br />
=== already there ===<br />
<br />
* bluesky<br />
** ams<br />
* hoekwater<br />
** context/contnav (is it needed? it's in ConTeXt already)<br />
** mflogo<br />
** misc/manfnt<br />
* public<br />
** marvosym<br />
<br />
=== temporary there ===<br />
<i>These fonts will be removed once there will be TeX Gyre math available.</i><br />
<br />
* urw<br />
** helvetic<br />
** palatino<br />
** times<br />
* public<br />
** pxfonts<br />
** txfonts<br />
<br />
=== superseeded by TeX Gyre ===<br />
<br />
* urw<br />
** avantgar (Adobe AvantGarde) -> Adventor<br />
** bookman -> Bonum<br />
** courier -> Cursor<br />
** helvetic -> Heros<br />
** ncntrsbk (Adobe New Century Schoolbook) -> Schola<br />
** palatino -> Pagella<br />
** times -> Termes<br />
** zapfchan -> Chorus<br />
* public<br />
** qfonts<br />
<br />
=== may be removed ===<br />
<br />
* bluesky<br />
** cm<br />
* public<br />
** cs<br />
** pl<br />
<br />
=== sort them first ===<br />
<br />
* adobe/utopia<br />
* bitstream/charter<br />
* bluesky<br />
** ams - check<br />
** latex-fonts -?<br />
* public<br />
** antp -?<br />
** cb<br />
** cm-super<br />
** eulervm<br />
** fourier<br />
* urw<br />
** symbol<br />
** utopia<br />
** zapfding<br />
<br />
== Math support needed ==<br />
<br />
http://www.ctan.org/tex-archive/info/Free_Math_Font_Survey/en/survey.html<br />
<br />
* Helvetica<br />
* Times: tx (see type-enc) or belleek or symbol math or omega math<br />
* Palatino: px (or Pazo) or euler<br />
<br />
* Bookman: kerkis (check)<br />
* Schoolbook: millenial/fourerenc<br />
<br />
* cmbright<br />
* Concrete and Euler or Concrete Math<br />
<br />
forget-me-not (how to generate map files for XeTeX):<br />
ctxtools --dpx --force --maproot=/usr/local/gwTeX/texmf.pkgs/fonts/map/dvips/tex-gyre<br />
<br />
<br />
<br />
== Different (check) ==<br />
<br />
* wcm for syrillic<br />
* la/lb/lc rb1000 etc.<br />
* lhr<br />
* cbgreek<br />
<br />
* computer concrete (AMS) - see type-enc<br />
* euler (AMS)<br />
* AMS symbols<br />
* fourier<br />
<br />
* \definefontsynonym [RalfSmithFormalScript] [rsfs10]<br />
* \definefontsynonym [MartinVogel] [fmvr8x]<br />
<br />
== Building plain formats (to be done) ==<br />
<br />
''This text will disapear from page, but until we put some additional files to the distribution, here are some notes for me.''<br />
<br />
There are no CMR fonts in the distribution (more or less on purpose), but you can use LM replacement instead.<br />
<br />
% pdftex.ini<br />
\pdfoutput=1<br />
\pdfcompresslevel=9<br />
\pdfdecimaldigits=3<br />
\pdfpagewidth=210 true mm<br />
\pdfpageheight=297 true mm<br />
\pdfhorigin=1 true in<br />
\pdfvorigin=1 true in<br />
\pdfpkresolution=600<br />
<br />
\input plain<br />
\dump<br />
\endinput<br />
<br />
pdftex -ini pdftex.ini<br />
<br />
One needs to use:<br />
\pdfmapfile{+lm-rep-cmtext.map}<br />
'''Bold text'''<br />
<br />
[[Category:Standalone|Implementation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=SyncTeX&diff=22511SyncTeX2014-06-03T14:49:33Z<p>Mojca Miklavec: ctxtools is no longer part of TL and ConTeXt distr., it's not really important any longer since when synctex was supported</p>
<hr />
<div>'''SyncTeX''' is a program that puts a lot of anchors in the output file that link to the corresponding position in the source file. This allows you to quickly jump from PDF to source. <br />
<br />
== Usage ==<br />
<br />
You can use the <code>--synctex</code> switch to enable SyncTeX.<br />
<br />
So in MkIV you can run<br />
context --synctex <i>jobname</i><br />
and in MkII you can use<br />
texexec --synctex <i>jobname</i><br />
<br />
This will create a file <code><i>jobname</i>.synctex.gz</code>. The command<br />
context --purge<br />
or next run without --synctex will remove the file again.<br />
<br />
This file can be used by your editor and PDF viewer to jump back and forth between the source and the PDF.<br />
<br />
== Editors & Viewers ==<br />
<br />
=== TeXWorks ===<br />
<br />
You may need to modify the command for executing ConTeXt first (you need to add <code>--synctex</code> switch in preferences).<br />
<br />
=== Evince ===<br />
Evince (the GNOME PDF viewer) supports SyncTeX since version 2.32.0.<br />
<br />
=== Skim.app & TextMate (Mac OS X) ===<br />
<br />
In Skim/Preferences/Sync choose TextMate. The key combination<br />
Shift + Apple + MouseClick<br />
will bring you to the corresponding line in text editor.<br />
<br />
In [[TextMate]] I have created my own command inside the ConTeXt bundle:<br />
<br />
* '''Save''': Nothing<br />
* '''Command(s)'''<br />
#!/bin/bash<br />
pdf=${TM_FILEPATH%tex}pdf<br />
/Applications/Skim.app/Contents/SharedSupport/displayline -r "$TM_LINE_NUMBER" "${pdf}"<br />
* '''Input''': None<br />
* '''Output''': Discard<br />
* '''Activation''': Key Equivalent (choose one; I used Ctrl+Alt+Apple+O)<br />
* '''Scope Selector''': text.tex.context<br />
<br />
If you use <code>Apple+R</code> for typesetting that needs to be modified as well (to account for --synctex switch).<br />
<br />
Hopefully this functionality will become part of the official ConTeXt bundle one day. (The recipe given above is too specific. The code needs to be written to handle more different viewers and different locations, not only a single viewer at a specified location.)<br />
<br />
{{Installation navbox}}<br />
<br />
[[Category:Text Editors]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Small_caps_across_styles_(bold,_italics,_etc.)&diff=22497Small caps across styles (bold, italics, etc.)2014-05-23T15:41:48Z<p>Mojca Miklavec: ConTeXt MKIV example for small caps</p>
<hr />
<div>< [[From LaTeX to ConTeXt]] ><br />
<br />
== In LaTeX ==<br />
<texcode><br />
\documentclass{article}<br />
\usepackage[T1]{fontenc}<br />
\begin{document}<br />
\textbf{\textsc{bold small caps}}<br />
\end{document}<br />
</texcode><br />
<br />
== In ConTeXt MKIV ==<br />
<br />
<texcode><br />
\starttext<br />
\setff{smallcaps} Normal and \bf bold Small Caps.<br />
\stoptext<br />
</texcode><br />
<br />
== In ConTeXt MKII ==<br />
<br />
<texcode><br />
\usemodule[cmscbf]<br />
\starttext<br />
{\sc Normal and \bf bold Small Caps.}<br />
\stoptext<br />
</texcode><br />
<br />
You can download the module t-cmscbf.tex from http://pmrb.free.fr/work/OS/ConTeXt/<br />
<br />
[[Category:Fonts]]<br />
[[Category:From LaTeX]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone/Mac_Installation&diff=22220ConTeXt Standalone/Mac Installation2014-01-08T12:53:42Z<p>Mojca Miklavec: set PATH instead of sourcing setuptex</p>
<hr />
<div>< [[ConTeXt Standalone]]<br />
<br />
This page describes an '''alternative''' of installing [[ConTeXt Standalone]] on Mac OS X. In particular it describes how to configure some GUI applications to work well with standalone.<br />
<br />
(It is '''enough''' to follow the steps described in [[ConTeXt Standalone]]. Some instructions on this page may cause difficulties that are hard to overcome.)<br />
<br />
==Mac newbie installation and configuration==<br />
<br />
The following assumes that you want to use ConTeXt and you are a not inside UNIX world (otherwise, see before and after). <br />
It guides you to install ConTeXt standalone installation under Mac in the typical Applications folder. Then it gives you some information<br />
about how to configure [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] to work as an editor for ConTeXt.<br />
Smultron is a Mac-only, open source text editor which is very easy to use and at the same time powerful (see also [http://en.wikipedia.org/wiki/Smultron]).<br />
<br />
===ConTeXt installation===<br />
<br />
1. Create a folder inside the Applications folder (in the Finder, press Command-Shift-A, Command-Shift-N) and name it “ConTeXtStandalone”<br />
<br />
(BEWARE: Installing in the Applications folder may cause permission problems!)<br />
<br />
2. Open a Terminal window (i.e., open the Terminal.app in your Utilities folder: a little window pops up)<br />
<br />
3. Type this: <br />
<code> cd /Applications/ConTeXtStandalone </code>, <br />
which means “change directory to ConTeXtStandalone”. Now you are working in the folder you have just created.<br />
<br />
4. Type this: <br />
<code> rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .</code> <br />
and press Return.<br />
<br />
This calls <code> rsync</code>, a program which goes to the contextgarden site (--> you must be connected to internet) and downloads the denoted file(s). To start, it simply downloads the little file <code> first-setup.sh</code>: this shell script contains a set of instructions which allow for automatic downloads (e.g., it selects the right files depending on which platform you are).<br />
<br />
To get the rest of the ConTeXt standalone, you have to execute this script by typing in Terminal <br />
<code>./first-setup.sh</code>. <br />
<br />
This will start the download and install process. Now (well, after a while) you have all the required files in the /Applications/ConTeXtStandalone folder.<br />
<br />
===Configuring ConTeXT===<br />
<br />
1. Open a text editor and create a file that has in it the following line: <br />
<code>. /Applications/ConTeXtStandalone/tex/setuptex /Applications/ConTeXtStandalone/tex</code>. <br />
Save this file as “.bash_profile” (see '''Where to put files''', below). (BEWARE: That might overwrite an existing .bash_profile!)<br />
<br />
Note: this file will be hidden, so make sure that you save it in the right place before completing the SAVE command. <br />
<br />
(There is a small utility for working with hidden files on the Mac called "Show/Hide Invisible Files": it is available at <code>http://www.macupdate.com/info.php/id/22318</code>.)You can find out more on [http://www.mac-how.net/ how to view hidden files on mac] on the official site of MacHow.<br />
<br />
2. Create a new folder named “texmf-local” inside ConTeXtStandalone/tex.<br />
<br />
3. Create another folder “web2c” inside this texmf-local folder.<br />
<br />
4. Inside your ConTeXtStandalone folder, locate the file named <code>texmf.cnf</code> that is in tex/texmf/web2c. Copy this file to ConTeXtStandalone/tex/texmf-local/web2c. Open this new texmf.cnf file, find the line<br />
<br />
TEXMFHOME = /nonexist <br />
<br />
and replace it with the single line<br />
<br />
TEXMFHOME = ~/texmf<br />
<br />
(WHY? Just use the newly created texmf-local and forget about the following steps! [[User:Hraban|Hraban]]Hraban)<br />
<br />
Again, replace the line<br />
<br />
TEXMF = {!!$TEXMFPROJECT,!!$TEXMFFONTS,!!$TEXMFLOCAL,!!$TEXMFCONTEXT,!!<br />
with the single line<br />
<br />
TEXMF = {$TEXMFHOME,!!$TEXMFPROJECT,!!$TEXMFFONTS,!!$TEXMFLOCAL,!!$TEXMFCONTEXT,!!$TEXMFEXTRA,!!$TEXMFMAIN}<br />
<br />
(See '''Where to put files''' below. These instructions assume that your personal texmf folder is in your Home folder. If you want it elsewhere, be sure to adjust the instructions in section 4 above accordingly.)<br />
<br />
5. In Terminal, type <code>luatools --generate</code> and press Enter/Return.<br />
<br />
6. In Terminal, type <code>context --make</code> and press Enter/Return.<br />
<br />
===Where to put files===<br />
<br />
''.bash_profile''<br />
<br />
There are several places that this file may go. One possibility is in your Home folder.<br />
You can also use the name ".profile".<br />
<br />
''personal texmf''<br />
<br />
Put your personal texmf folder where it will not get clobbered by future updates. Some possibilities:<br />
<br />
(a) inside your Home folder. (Your Home folder is the one that has the house icon.)<br />
<br />
(b) inside the Library folder in your Home folder.<br />
<br />
===Smultron installation and configuration===<br />
<br />
1. Smultron is a Mac application. To install it, simply download the dmg and put the app under the Applications folder (as usual) <br />
<br />
2. Open Smultron and go under Tools-->Handle Commands-->Show Commands Window<br />
<br />
3. The resulting window allows you to define some commands which can be executed by Smultron. Substantially, this means that Smultron opens for you a Terminal, types the code you want and presses return.<br />
<br />
4. Create a new command by pressing the "New Command" button and type a name (e.g. "standaloneTexexec"). Then, write in the text field at the bottom:<br />
<br />
<pre><br />
#!/bin/bash <br />
export PATH=/Applications/ConTeXtStandalone/tex/texmf-osx-64/bin:$PATH<br />
texexec %%p<br />
</pre><br />
<br />
<code>texexec</code> is the command you should call from the Terminal to run ConTeXt.<br />
Now Smultron can do it for you.<br />
<br />
5. Write your ConTeXt file with Smultron and save it. When you want to compile it, simply go under Tools-->Commands-->Other-->standaloneTexexec. This will generate a pdf file in the same folder of your .tex file.<br />
<br />
6. If you want to experiment with LuaTeX (ConTeXt MkIV) simply add another command (you can name it e.g. "standaloneLua") with this text in its text field:<br />
<br />
<pre><br />
#!/bin/bash<br />
export PATH=/Applications/ConTeXtStandalone/tex/texmf-osx-64/bin:$PATH<br />
context %%p<br />
</pre><br />
<br />
6b. If you explore the Commands window, you will see that clicking under the Shortcut tab you can insert a shortcut.<br />
<br />
6c. If you want to see what ConTeXt is telling you (which is fundamental in case of unexpected behaviors) you can select Tools-->Handle Commands-->Show Command Result Window. This will open a window mirroring the content of the Terminal (i.e. what ConTeXt is communicating you)<br />
<br />
7. If you want an automatic update of the pdf you are workin on you can use another mac app, [http://pdfview.sourceforge.net/ pdfview]. You have simply to install it, open your pdf file and choose the automatic update option. Every time you recompile form Smultron (or by another editor), it updates the displayed pdf<br />
<br />
Here we are not using the famous TeXShop editor, because it is slightly more complicated, and typically you grab it bundled with a TeX distribution (like MacTeX), and opportunely configured. By using Smultron, we have created a completely autonomous and lightweight ConTeXTStandalone installation which can work aside MacTeX/TeXShop installation. More, by pdfview we have auto update, which is one of the very relevant feature of TeXShop (If you do not know about all this stuff, see [http://wiki.contextgarden.net/Mac_Installation Mac installation]<br />
<br />
===TeXShop installation and configuration===<br />
<br />
TeXShop is a popular TeX editor for Mac OS X.<br />
<br />
1. To install it, download the disk image from <code>http://www.uoregon.edu/~koch/texshop/obtaining.html</code> and put this app in the Applications folder alongside your ConTeXTStandalone folder.<br />
<br />
2. Launch TeXShop. It will automatically create the necessary support files. <br />
<br />
3. Create an empty text document with your favorite text editor or TeXShop. Then, insert the following text into the document:<br />
<pre> <br />
#!/bin/bash<br />
export PATH=/Applications/ConTeXtStandalone/tex/texmf-osx-intel/bin:$PATH<br />
texexec "$1"<br />
</pre><br />
4. SAVE this document in your Home folder in “Library/TeXShop/Engines/” AS “ConTeXt-MKII.engine”. (TeXShop offers the .engine file format). After you have saved the file, open Terminal, navigate to /Library/TeXShop/Engines in your Home folder using <code>cd ~/Library/TeXShop/Engines/</code>. Then, run <code>chmod +x ConTeXt-MKII.engine</code> .<br />
<br />
<br />
5. Repeat steps 3 and 4, by creating a file named “ConTeXt-MKIV.engine” that contains the lines:<br />
<pre><br />
#!/bin/bash<br />
export PATH=/Applications/ConTeXtStandalone/tex/texmf-osx-64/bin:$PATH<br />
export TEXMFCACHE=/Applications/ConTeXtStandalone/tex/texmf-cache<br />
context "$1"<br />
</pre><br />
<br />
Please note that the directory might be called texmf-osx-64 on your computer.<br />
<br />
6. Repeat steps 3 and 4 once more, by creating a file named “ConTeXt-XeTeX.engine” that contains the lines:<br />
<pre><br />
#!/bin/bash<br />
export PATH=/Applications/ConTeXtStandalone/tex/texmf-osx-64/bin:$PATH<br />
texexec --xtx "$1"<br />
</pre><br />
<br />
===Typesetting with TeXShop===<br />
<br />
1. Close all open documents in TeXShop, open a new one, go the the Engine menu (immediately to the right of the “Typeset” button in the Toolbar), and select one of<br />
<pre><br />
ConTeXt-MKII<br />
ConTeXt-MKIV<br />
ConTeXt-XeTex<br />
</pre><br />
This will instruct TeXShop to use this engine to compose your documents.<br />
<br />
2. Edit your ConTeXt document with TeXShop. In the TeXShop toolbar, in the “Typeset” menu, choose “ConTeXt” and “Pdftex”. (Check the TeXShop preferences for more settings.) When you want to typeset the document, simply hit Command-T press or “Typeset” at the top of the document window. This will generate a PDF file in the same folder of your .tex file.<br />
<br />
===Notes===<br />
<br />
All the process requires that you have installed on your machine rsync, ruby and perl. But if you are on MacOS X, Apple should already have provided it, so at 99% there should not be problems.<br />
<br />
[[Category:Installation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone/Implementation&diff=21369ConTeXt Standalone/Implementation2013-01-04T10:22:19Z<p>Mojca Miklavec: update links to binary sources (added luajittex, xetex is now in git, ...)</p>
<hr />
<div>< [[ConTeXt Standalone]] | [[ConTeXt Standalone/Structure]] ><br />
<br />
<br />
Binaries can now be built from<br />
svn co http://svn.contextgarden.net/suite/build-binaries<br />
It might take some time to propagate the changes and auto-update this page :)<br />
<br />
== Binary sources ==<br />
<br />
We take binaries from the following sources:<br />
<br />
=== MetaPost ===<br />
* SVN: http://foundry.supelec.fr/svn/metapost<br />
* ViewVC:http://foundry.supelec.fr/gf/project/metapost/scmsvn/<br />
* files: http://foundry.supelec.fr/gf/project/metapost/frs/<br />
<code>tags/XXX</code><br />
<br />
=== LuaTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/luatex<br />
* ViewVC: http://foundry.supelec.fr/gf/project/luatex/scmsvn/<br />
* Files: http://foundry.supelec.fr/gf/project/luatex/frs/<br />
<code>tags/beta-XXX</code><br />
<br />
=== LuaJITTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/luajittex<br />
* ViewVC: http://foundry.supelec.fr/gf/project/luajittex/scmsvn/<br />
<code>tags/beta-XXX</code><br />
<br />
=== W32TeX ===<br />
<br />
* http://w32tex.org<br />
<br />
=== TeX Live 2012 ===<br />
<br />
* http://www.tug.org/texlive/svn/<br />
<br />
=== Others (not used any more) ===<br />
<br />
We also used to compile pdfTeX and XeTeX, but stopped doing so as there was no need to use a version newer than what's in TeX Live.<br />
<br />
==== pdfTeX ====<br />
* SVN: http://foundry.supelec.fr/svn/pdftex<br />
* VieVC: http://foundry.supelec.fr/gf/project/pdftex/scmsvn/<br />
<code>branches/stable/source</code><br />
<br />
==== XeTeX ====<br />
* GIT: git://git.code.sf.net/p/xetex/code<br />
* Gitweb: http://xetex.git.sourceforge.net/<br />
<code>master</code><br />
<br />
== rsync ==<br />
<br />
Rsync on Windows behaves a bit weird. We fetched binaries from<br />
* http://www.itefix.no/cwrsync/<br />
One needs to set<br />
set CYGWIN=noNTsec<br />
before syncing binaries or<br />
chmod 777 tex/texmf-win/bin/*<br />
after that, else binaries won't work.<br />
<br />
From rsync bundle one needs to have at least<br />
chmod.exe<br />
cygiconv-2.dll # for chmod<br />
cygintl-3.dll # for chmod<br />
cygwin1.dll<br />
rsync.exe<br />
to be able to use rsync from the garden properly. I have no idea what happens if cygwin is in PATH, but it is asking for problems.<br />
<br />
<br />
<br />
== Cross-compiling on Mac OS X ==<br />
<br />
In order to cross-compile for PPC on a Intel Mac, you need to give the compiler and the linker the following additional switches:<br />
<br />
-arch ppc<br />
<br />
So all you have to do is set <code>CFLAGS</code> and <code>LDFLAGS</code> before you run <code>configure</code> (as well as <code>CXXFLAGS</code>, if applicable). Of course it may be that some Makefiles don't honor these variables and override them with something of their own, and this is the major inconvience you will have to deal with (this is actually what the Makefile for lua does; here you would have to set something like <code>MYCFLAGS</code> or <code>XCFLAGS</code> in addition).<br />
<br />
Obviously, you can also use a similar instruction to cross-compile the other way round (build for Intel on a PPC host); it's called <code>-arch i386</code>; and if you give both at the same time, it results with a so-called ''universal'' binary (the size of which being approximately the sum of the size of both individual binaries). [[User:Arthur|Arthur]] 17:20, 30 September 2007 (CEST)<br />
<br />
For pdfTeX it's enough to say<br />
CFLAGS="-arch ppc" LDFLAGS="-arch ppc" CXXFLAGS="-arch ppc" ./build.sh<br />
<br />
XeTeX supports the syntax<br />
./build-xetex "-arch ppc"<br />
for cross-compiling.<br />
<br />
It is also adviced to use<br />
gcc_select<br />
and select gcc 3.3 to be more backward compatible, as well as setting<br />
export MACOSX_DEPLOYMENT_TARGET=10.3<br />
<br />
== Compiling TeX Live binaries ==<br />
<br />
To compile 64-bit binaries on 10.6 or later:<br />
./Build --disable-xdvipdfmx --disable-xetex --disable-xdv2pdf<br />
To select the latest compiler on Lion:<br />
CC=clang OBJC=clang CXX=clang++ ./Build <options><br />
If we want to compile for 10.6 on 10.7 we additionally need:<br />
export MACOSX_DEPLOYMENT_TARGET=10.6<br />
# or add -mmacosx-version-min=10.6 to CFLAGS<br />
# most of the time optional; usually not needed, but one never knows<br />
export MYCFLAGS='-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk'<br />
export CC=llvm-gcc-4.2; export CFLAGS=$MYCFLAGS<br />
export OBJC=llvm-gcc-4.2; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=llvm-g++-4.2; export CXXFLAGS=$MYCFLAGS<br />
./Build <options><br />
<br />
To compile ppc and i386 binaries for Tiger on 10.6:<br />
export ARCH=i386<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-arch $ARCH -isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export LDFLAGS='-arch $ARCH'<br />
export CC=gcc-4.0; export CFLAGS=$MYCFLAGS<br />
export OBJC=gcc-4.0; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=g++-4.0; export CXXFLAGS=$MYCFLAGS<br />
<br />
Or alternatively:<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=i686-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=i686-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=i686-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=powerpc-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=powerpc-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=powerpc-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
= Non-Polish Fonts =<br />
<br />
== List of fonts in the old minimals ==<br />
<br />
=== already there ===<br />
<br />
* bluesky<br />
** ams<br />
* hoekwater<br />
** context/contnav (is it needed? it's in ConTeXt already)<br />
** mflogo<br />
** misc/manfnt<br />
* public<br />
** marvosym<br />
<br />
=== temporary there ===<br />
<i>These fonts will be removed once there will be TeX Gyre math available.</i><br />
<br />
* urw<br />
** helvetic<br />
** palatino<br />
** times<br />
* public<br />
** pxfonts<br />
** txfonts<br />
<br />
=== superseeded by TeX Gyre ===<br />
<br />
* urw<br />
** avantgar (Adobe AvantGarde) -> Adventor<br />
** bookman -> Bonum<br />
** courier -> Cursor<br />
** helvetic -> Heros<br />
** ncntrsbk (Adobe New Century Schoolbook) -> Schola<br />
** palatino -> Pagella<br />
** times -> Termes<br />
** zapfchan -> Chorus<br />
* public<br />
** qfonts<br />
<br />
=== may be removed ===<br />
<br />
* bluesky<br />
** cm<br />
* public<br />
** cs<br />
** pl<br />
<br />
=== sort them first ===<br />
<br />
* adobe/utopia<br />
* bitstream/charter<br />
* bluesky<br />
** ams - check<br />
** latex-fonts -?<br />
* public<br />
** antp -?<br />
** cb<br />
** cm-super<br />
** eulervm<br />
** fourier<br />
* urw<br />
** symbol<br />
** utopia<br />
** zapfding<br />
<br />
== Math support needed ==<br />
<br />
http://www.ctan.org/tex-archive/info/Free_Math_Font_Survey/en/survey.html<br />
<br />
* Helvetica<br />
* Times: tx (see type-enc) or belleek or symbol math or omega math<br />
* Palatino: px (or Pazo) or euler<br />
<br />
* Bookman: kerkis (check)<br />
* Schoolbook: millenial/fourerenc<br />
<br />
* cmbright<br />
* Concrete and Euler or Concrete Math<br />
<br />
forget-me-not (how to generate map files for XeTeX):<br />
ctxtools --dpx --force --maproot=/usr/local/gwTeX/texmf.pkgs/fonts/map/dvips/tex-gyre<br />
<br />
<br />
<br />
== Different (check) ==<br />
<br />
* wcm for syrillic<br />
* la/lb/lc rb1000 etc.<br />
* lhr<br />
* cbgreek<br />
<br />
* computer concrete (AMS) - see type-enc<br />
* euler (AMS)<br />
* AMS symbols<br />
* fourier<br />
<br />
* \definefontsynonym [RalfSmithFormalScript] [rsfs10]<br />
* \definefontsynonym [MartinVogel] [fmvr8x]<br />
<br />
== Building plain formats (to be done) ==<br />
<br />
''This text will disapear from page, but until we put some additional files to the distribution, here are some notes for me.''<br />
<br />
There are no CMR fonts in the distribution (more or less on purpose), but you can use LM replacement instead.<br />
<br />
% pdftex.ini<br />
\pdfoutput=1<br />
\pdfcompresslevel=9<br />
\pdfdecimaldigits=3<br />
\pdfpagewidth=210 true mm<br />
\pdfpageheight=297 true mm<br />
\pdfhorigin=1 true in<br />
\pdfvorigin=1 true in<br />
\pdfpkresolution=600<br />
<br />
\input plain<br />
\dump<br />
\endinput<br />
<br />
pdftex -ini pdftex.ini<br />
<br />
One needs to use:<br />
\pdfmapfile{+lm-rep-cmtext.map}<br />
'''Bold text'''<br />
<br />
[[Category:Standalone|Implementation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone&diff=21366ConTeXt Standalone2013-01-02T17:07:34Z<p>Mojca Miklavec: update the list of binary builders</p>
<hr />
<div>< [[Installation]] | [[ConTeXt Standalone/FAQ|Standalone/FAQ]] | '''[[ConTeXt Standalone/Tree|Standalone/Tree]]''' | [[ConTeXt Standalone/Structure|Standalone/Structure]] | [[ConTeXt Standalone/Implementation|Standalone/Implementation]] | [[ConTeXt Standalone/TODO|Standalone/TODO]] | [[ConTeXt Standalone/Contents|Standalone/Contents]] | [[ConTeXt Standalone/TeX Live|Standalone/TeX Live]] ><br />
<br />
The '''ConTeXt suite''' is a complete, up-to-date ConTeXt distribution which can be upgraded efficiently. It can be used to install either the stable or the beta version of ConTeXt. It can also be used in parallel with existing TeX installations such as MikTeX, TeXLive, or older minimal installation. It is aimed towards ConTeXt users, so it does not include LaTeX specific packages and binaries. <br />
<br />
{{note | ConTeXt develops at a fast pace, and sometimes beta releases have serious bugs. ConTeXt suite allows you to test the latest ConTeXt release without having to worry if an upgrade will mess an critical project. You can have two (or multiple) parallel ConTeXt suites, and freeze one for your critical projects, and use the other one for experimenting.}}<br />
<br />
ConTeXt is also included in TeXlive. The ConTeXt suite is updated continuously, whereas ConTeXt in TeXlive is updated less often. In particular, <code>luatex</code> and <code>metapost</code> are under active development and their binaries are updated frequently. ConTeXt follows these developments, indeed often drives development. As the binaries included in the TeXlive distribution are only updated yearly, ConTeXt on TeXlive will necessarily be less current than the ConTeXt suite. (ConTeXt on TeXlive can be kept somewhat more current using the http://tlcontrib.metatex.org repository.) The ConTeXt suite is self-contained and can happily coexist alongside another installed TeX distribution.<br />
<br />
{{TOClimit|limit=1}}<br />
<br />
= General Information =<br />
<br />
== Supported platforms ==<br />
<br />
{| style="border:1px solid #DDDDDD;"<br />
|- align="left" <br />
! Platform<br />
! Short name<br />
! Binaries by<br />
! Notes<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Windows<br />
| mswin<br />
| Akira Kakuto ([http://w32tex.org W32TeX])<br />
|<br />
|- align="left"<br />
! Linux<br />
| linux<br />
| Hans Hagen, Mojca Miklavec, Alan Braslau<br />
| compiled with glibc 2.3.6<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, 64-bit<br />
| linux-64<br />
| Peter Münster<br />
|<br />
|- align="left"<br />
! Linux, PowerPC<br />
| linux-ppc<br />
| Piotr Kopszak<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Linux, Arm (low end.)<br />
| linux-armel<br />
| Boris Veytsman<br />
| in progress<br />
|- align="left"<br />
! Mac OS X, Intel (32-bit)<br />
| osx-intel<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Intel (64-bit)<br />
| osx-64<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left"<br />
! Mac OS X, PowerPC<br />
| osx-ppc<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Mac OS X, Universal Binaries<br />
| osx-universal<br />
| Richard Koch, Mojca Miklavec<br />
|<br />
|- align="left"<br />
! FreeBSD<br />
| freebsd<br />
| Alan Braslau<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! FreeBSD, 64-bit<br />
| freebsd-amd64<br />
| Alan Braslau<br />
| <br />
|- align="left"<br />
! kFreeBSD<br />
| kfreebsd-i386<br />
| Alan Braslau<br />
| FreeBSD + glibc (Debian)<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! kFreeBSD, 64-bit<br />
| kfreebsd-amd64<br />
| Alan Braslau<br />
| FreeBSD + glibc (Debian)<br />
|- align="left"<br />
! Solaris, Intel<br />
| solaris-intel<br />
| Marco Patzer<br />
|<br />
|- align="left" style="background-color:#EEEEEE;"<br />
! Solaris, Sparc<br />
| solaris-sparc<br />
| Mojca Miklavec<br />
| Solaris 10 on [http://www.opencsw.org/about/ OpenCSW]<br />
|}<br />
<br />
We need volunteers for providing binaries for other platforms. If you want to support a platform, please write to [[ConTeXt Mailing Lists]]<br />
<br />
== Dependencies ==<br />
* [http://www.ruby-lang.org Ruby] 1.8 or newer (used for MKII)<br />
* Rsync (The windows binary of rsync is distributed within the suite)<br />
<br />
<br />
The following programs are not required for running ConTeXt, but their installation adds additional functionality.<br />
<br />
* ghostscript : for converting PostScript images to PDF<br />
* graphicmagick : for converting GIF and TIFF images<br />
* inkscape : for converting SVG and compressed SVG<br />
* pstoedit : for converting PostScript to MetaPost outlines<br />
* zint : for providing barcodes<br />
* curl : for including remote content<br />
<br />
== Disc space required ==<br />
ConTeXt macro files are small (less than 10MB), but the suite comes with various free fonts which considerably increase the size of the distribution to around 200MB).<br />
<br />
== Installation tree ==<br />
Browse the [http://minimals.contextgarden.net installation tree]<br />
<br />
<br />
<br />
= Unix-like platforms (Linux/MacOS X/FreeBSD/Solaris) =<br />
<br />
<br />
== Single user installation ==<br />
<br />
Select a folder where you want to install ConTeXt. We recommend that you can use your <code>$HOME/context</code> directory. Create this folder. Then download <br />
[http://minimals.contextgarden.net/setup/first-setup.sh first-setup.sh] and place it in <code>$HOME/context</code> directory. Open a terminal, then:<br />
<br />
cd context<br />
<br />
Then make <code>first-setup.sh</code> executable and run it to download the whole distribution and make formats:<br />
<br />
chmod +x first-setup.sh<br />
sh ./first-setup.sh<br />
<br />
This takes a long time, so go have a coffee.<br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use<br />
<br />
sh ./first-setup.sh --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
sh ./first-setup.sh --modules=all<br />
<br />
Installing mkiv only reduces the size of the installation (including all the modules) from about 270 to 200MB . Use<br />
<br />
sh ./first-setup.sh --modules=all --engine=luatex<br />
<br />
== System-wide installation ==<br />
<br />
A system wide installation is only recommeded for users who are comfortable with the command line. Only the location of installing ConTeXt is different for a system wide installation.<br />
<br />
* on Linux you can use <code>/opt/context</code><br />
* on MacOS X you can use <code>/Applications/ConTeXt</code><br />
<br />
Note that, at present, while ''using'' MkIV, you need to have write permissions<ref>Actually, you only need write permission for <code>$TEXMFCACHE</code>.</ref> in the installation directory.<ref>This effectively means that only one user will be able to generate the formats</ref> So, if you are installing the suite in <code>/opt/context</code> or <code>/Applications/ConTeXt</code>, run<br />
<br />
chown `whoami` -R /opt/context <br />
<br />
or <br />
<br />
chown `whoami` -R /Applications/ConTeXt<br />
<br />
(<code>`whoami`</code> outputs your user name, you can type that directly, of course.)<br />
<br />
In order to install the suite, open a terminal, go to the installation directory and download [http://minimals.contextgarden.net/setup/first-setup.sh first-setup.sh]:<br />
<br />
$ rsync -av rsync://contextgarden.net/minimals/setup/first-setup.sh .<br />
<br />
Then run that script to download the whole distribution and make formats:<br />
<br />
sh ./first-setup.sh<br />
<br />
This takes a long time, so go have a coffee.<br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use<br />
<br />
sh ./first-setup.sh --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
sh ./first-setup.sh --modules=all<br />
<br />
===Cache===<br />
<br />
Normaly you do not want to allow access in e.g. /opt. but you like to allow it in /var/cache/*. So create the needed cache directory as a superuser via<br />
<br />
mkdir /var/cache/context<br />
mkdir /var/cache/context/texmf-cache<br />
chmod 777 /var/cache/context/texmf-cache<br />
<br />
Change in the file ./tex/texmf/web2c/texmfcnf.lua the value of TEXMFCACHE to the directory you want (in this example /var/cache/context/texmf-cache).<br />
<br />
===Font Directory===<br />
<br />
Add the OSOFONTDIR into ./tex/setuptex. Go to under the line:<br />
<br />
# TODO: we could set OSFONTDIR on Mac for example<br />
<br />
(if you don't have the line above, go to the end of the file) and add there:<br />
<br />
export OSFONTDIR="/usr/local/share/fonts;$HOME/.fonts"<br />
<br />
For more information: [[Fonts in LuaTeX]]<br />
<br />
==Arch Linux==<br />
There’s a [http://aur.archlinux.org/packages.php?ID=30398 PKGBUILD] in<br />
the AUR, provided by Aditya [https://github.com/adityam/context-pkgbuild].<br />
Install it using your favorite AUR frontend, e.g.<br />
<br />
<pre><br />
yaourt -S context-minimals-git<br />
</pre><br />
<br />
This will get you a fresh, up-to-date Context tree in<br />
<tt>/opt/context-minimals</tt>.<br />
<br />
== The funtoo way ==<br />
<br />
If you are using [http://funtoo.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Standalone Funtoo]] Howto. This might also work for [http://www.gentoo.org gentoo], but is untested right now.<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal or your startup script (<code>.bashrc</code> or the corresponding file for your shell). Replace username, password, proxyhost and proxyport with the correct information<br />
<br />
export RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
ConTeXt suite works in a non-interfering manner because it does not put anything in your <code>$PATH</code> and does not set any system variables. This in turn means that in order to use it, you need to do some initialization. An intialization script called <code>setuptex</code> is provided in <code>installation-dir/tex/</code>. <br />
<br />
If you run context from a terminal, source <code>setuptex</code> like so:<br />
<br />
source /installation-dir/tex/setuptex<br />
<br />
== Exclusive usage ==<br />
<br />
The above method means that you always have to type <code>source /installation-dir/tex/setuptex</code> in a terminal before you can use typeset. If you always use ConTeXt suite and never use LaTeX or plain TeX provided by another TeX distribution, you can add the above intialization line to the startup script of your shell. For bash, this means <code>$HOME/.bashrc</code>; for zsh, this means <code>$HOME/.zshrc</code>; for (t)csh, this means <code>$HOME/.cshrc</code> or <code>$HOME/.tcshrc</code>. Then, <code>setuptex</code> will always be sourced in your terminal. <br />
<br />
== Integrating with an editor ==<br />
<br />
If you run ConTeXt from an editor, you need to source {{code|setuptex}} in a terminal and then open your editor from the same terminal. <br />
<br />
Depending on how your editor initializes, you may still need to source {{code|setuptex}} in order to run ConTeXt directly from your editor. In theory, it is sufficient to add {{code|/installation-dir/tex/texmf-<platform>/bin}} to your {{code|$PATH}} in order to use the suite. You can try to add this to the paths that your editor searches.<br />
<br />
For information about configuring [http://smultron.sourceforge.net/ Smultron] and [http://www.uoregon.edu/~koch/texshop/obtaining.html TeXShop] (which are popular TeX editors on Mac) see [[ConTeXt Standalone/Mac Installation]]. For a list of text editors with ConTeXt integration, see the article on [[Text Editors|text editors]].<br />
<br />
== Updating ==<br />
<br />
For updating the ConTeXt suite, <br />
first update <code>first-setup.sh</code>, then run it. You could<br />
also create an alias or a little script “ctx-update”<br />
with the following example contents:<br />
<pre><br />
cd /opt/context<br />
rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .<br />
./first-setup.sh --modules=all<br />
</pre><br />
<br />
== Uninstalling ==<br />
<br />
ConTeXt suite does not touch anything outside its installation folder. So to uninstall it, you can simply remove the installation folder.<br />
<br />
== Remaking formats ==<br />
<br />
Normally, the update script should create the formats for you. If for some reason you need to recreate the formats, you can do the following:<br />
<br />
* For making MKII format.<br />
<br />
mktexlsr<br />
texexec --make --all <br />
<br />
* For making XeTeX format<br />
<br />
mktexlsr<br />
texexec --make --xtx --all <br />
<br />
* For making MKIV format<br />
<br />
mtxrun --selfupdate<br />
mtxrun --generate<br />
luatools --generate<br />
context --make<br />
<br />
= Installation and use on Windows =<br />
<br />
If you want to use ConTeXt suite alongside MikTeX/TeXLive (needed if you also run LaTeX), follow the command-line installation method. Otherwise, you can follow either the command line or GUI installation method.<br />
<br />
== Installation ==<br />
<br />
=== Command line method ===<br />
Download [http://minimals.contextgarden.net/setup/context-setup-mswin.zip context-setup-mswin.zip] and unzip to a directory where you want to install ConTeXt. It is recommended that you choose a directory that does not have a space in its full path. Then open <code>cmd.exe</code>, go to the installation directory and run<br />
<br />
first-setup.bat<br />
<br />
This takes a long time, so go have a coffee. <br />
<br />
By default, the suite installs ConTeXt beta. If you want the stable version of ConTeXt, you can use <br />
<br />
first-setup.bat --context=current<br />
<br />
By default, the suite does ''not'' install modules and other third party content. If you want the modules (and have the bandwidth), you can use<br />
<br />
first-setup.bat --modules=all<br />
<br />
<br />
If the above installation instructions don't seem to answer your questions, see page [[Windows_Installation:_ConTeXt_Suite_with_SciTe| Windows Installation: ConTeXt Suite with SciTe]] for more detailed information.<br />
<br />
=== GUI Installer ===<br />
<br />
{{note|The installer seems to have been broken since autumn 2010 and still is in November 2011, at least in some versions of Windows, so proceed at your own risk.}}<br />
<br />
There is also a [http://minimals.contextgarden.net/setup/context-installer/ContextMinimalInstall.exe GUI installer] made by Vyatcheslav Yatskovsky. Download and run the installer and it will ask you where to install the minimals, which distribution to use (stable or beta) and whether or not you want to make formats. <br />
<br />
{{note| The GUI installer asks if you want to set environmental variables globally. Click this only if you do '''not''' use MikTeX or TeXLive and do '''not''' plan to use LaTeX}}<br />
<br />
You should also see the [http://meeting.contextgarden.net/2008/talks/2008-08-21-vyatcheslav-win-installer/windows_installer.pdf slides] giving details about the GUI installer.<br />
<br />
== Proxy settings ==<br />
<br />
The installation script uses <code>rsync</code> to fetch the required files. So, if you are behind a proxy server, you need to tell the details to rsync. The easiest way to set this is to set <code>RSYNC_PROXY</code> variable in the terminal as (replace username, password, proxyhost and proxyport with the correct information)<br />
<br />
set RSYNC_PROXY=username:password@proxyhost:proxyport<br />
<br />
or set the variable permanently as a Windows environment variable.<br />
<br />
Sometimes, when behind a firewall, port 873 may be closed for outgoing TCP connections. If port 22 is open for ssh connections, a trick that can be used is to connect to a computer located somewhere outside of the firewall and to tunnel port 873 (using the program <code>nc</code>).<br />
<br />
export RSYNC_CONNECT_PROG='ssh tunnelhost nc %H 873'<br />
<br />
where <code>tunnelhost</code> is the machine outside of the firewall on which you have <code>ssh</code> access. Of course, this machine must have <code>nc</code> and port 873 open for outgoing TCP connections.<br />
<br />
== Usage ==<br />
<br />
If you used the GUI installer and said yes to setting the evironmental variables globally, then you can run ConTeXt from anywhere. Otherwise, before running ConTeXt, you need to run <code>setuptex.bat</code> which is provided in <code>installation-dir\tex\</code>. This can be done by typing<br />
<br />
installation-dir\tex\setuptex.bat<br />
<br />
on cmd.exe before you run ConTeXt. To avoid always having to type this, you can create a shortcut to cmd.exe and edit the command line to read (assuming you installed the suite in <code>C:\Programs</code>; otherwise replace <code>C:\Programs\</code> with your installation directory)<br />
<br />
C:\WINDOWS\System32\cmd.exe /k C:\Programs\context\tex\setuptex.bat<br />
<br />
This starts up a new command shell with the environment pre-loaded.<br />
<br />
=== Use ConTeXt with Cygwin ===<br />
After installing the ConTeXt suite, you can run it under Cygwin. With Cygwin, you may use gmake and other Unix tools for your automated workflow.<br />
<br />
# Run <code>setuptex.bat</code> in DOS command prompt<br />
# In the same DOS prompt, enter Cygwin by running <code>cygwin.bat</code> (in your Cygwin installation directory)<br />
# Under Cygwin prompt, run <code> context.cmd test.tex </code>. Note that the <code>.cmd</code> extension is needed under Cygwin.<br />
<br />
== Updating ==<br />
<br />
If you used the command line method, just run <code>first-setup.bat</code> again to update the suite. If you have third party modules installed, you should use<br />
first-setup.bat --keep<br />
to upgrade. See [[ConTeXt_Standalone#Installing_third_party_modules| Installing third party modules]] for details.<br />
<br />
If you used the GUI installer, just run the installer again.<br />
<br />
== Uninstallation ==<br />
<br />
If you used the command-line installer, you can just delete the installation directory to uninstall the suite.<br />
<br />
If you used the GUI installer, you can use standard windows tools for uninstallation.<br />
<br />
<br />
== Troubleshooting ==<br />
<br />
* rsync sometimes has problems with paths with uppercase letters (like <code>c:\Temp</code> or <code>C:\Documents and Settings</code>). Installing into all-lowercase paths without spaces sometimes helps.<br />
* Directory-name length may also have an effect, due to Windows's 8.3 filename conventions. An indicator is if running "texexec --lua" on a file produces missing-file warnings containing Windows-created 8-character directory names, such as "C:\CONTEX~1\tex", where your ConTeXt directory is really "C:\context_minimals\tex". Be conservative and choose a short name like "C:\ctm\tex". Also, this may even work when an 8-character-or-less directory name like "C:\ctexmin\tex" doesn't.<br />
* If you're behind firewall and rsync times out, you need to open port 873 for outgoing TCP connections.<br />
<br />
= Installing third party modules =<br />
<br />
The ConTeXt suite only comes with Taco's [[Bibliography|t-bib]] module. If you want to install [http://modules.contextgarden.net/ a new module], say Wolfgang's [[Letter|t-letter]] module, you can use<br />
first-setup.sh --modules="t-letter"<br />
<br />
If you want to install more than one extra module, you can separate them by commas. So, to install the t-letter and t-mathsets module, do<br />
sh ./first-setup.sh --modules="t-letter,t-mathsets"<br />
<br />
If you want to install all extra modules at once, do<br />
sh ./first-setup.sh --modules=all<br />
<br />
= Reverting to an older installation =<br />
<br />
If, for some reason, you want to revert to an older installation, you can do that by<br />
<br />
sh ./first-setup.sh --context=date<br />
<br />
where <code>date</code> is the date of one of the stable releases of ConTeXt. The complete list of old releases that are available is [http://minimals.contextgarden.net/current/context/ here].<br />
<br />
<br />
= Moving the installation tree around = <br />
<br />
According to this post, http://archive.contextgarden.net/message/20101129.144331.d721372f.en.html it's safe to move the installation tree across directory or machines (say you don't have broadband access). You just have to clean and regenerate the cache (./tex/texmf-cache/luatex-cache) with <br />
mtxrun --generate<br />
<br />
= Notes =<br />
<references/><br />
<br />
{{Installation navbox}}<br />
{{Getting started navbox}}<br />
[[Category:Installation]]<br />
[[Category:Standalone]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone/Implementation&diff=21301ConTeXt Standalone/Implementation2012-12-03T10:07:05Z<p>Mojca Miklavec: a different repository with source code</p>
<hr />
<div>< [[ConTeXt Standalone]] | [[ConTeXt Standalone/Structure]] ><br />
<br />
<br />
Binaries can now be built from<br />
svn co http://svn.contextgarden.net/suite/build-binaries<br />
It might take some time to propagate the changes and auto-update this page :)<br />
<br />
== Binary sources ==<br />
<br />
We take binaries from the following sources:<br />
<br />
=== MetaPost ===<br />
* SVN: http://foundry.supelec.fr/svn/metapost<br />
* ViewVC:http://foundry.supelec.fr/gf/project/metapost/scmsvn/<br />
* files: http://foundry.supelec.fr/gf/project/metapost/frs/<br />
<code>tags/XXX</code><br />
<br />
=== pdfTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/pdftex<br />
* VieVC: http://foundry.supelec.fr/gf/project/pdftex/scmsvn/<br />
<code>branches/stable/source</code><br />
<br />
=== luaTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/luatex<br />
* ViewVC: http://foundry.supelec.fr/gf/project/luatex/scmsvn/<br />
* Files: http://foundry.supelec.fr/gf/project/luatex/frs/<br />
<code>tags/beta-XXX</code><br />
<br />
=== XeTeX ===<br />
* http://scripts.sil.org/svn-public/xetex/TRUNK<br />
<code>trunk</code><br />
<br />
=== TeX Live 2012 ===<br />
<br />
* http://www.tug.org/texlive/svn/<br />
<br />
== rsync ==<br />
<br />
Rsync on Windows behaves a bit weird. We fetched binaries from<br />
* http://www.itefix.no/cwrsync/<br />
One needs to set<br />
set CYGWIN=noNTsec<br />
before syncing binaries or<br />
chmod 777 tex/texmf-win/bin/*<br />
after that, else binaries won't work.<br />
<br />
From rsync bundle one needs to have at least<br />
chmod.exe<br />
cygiconv-2.dll # for chmod<br />
cygintl-3.dll # for chmod<br />
cygwin1.dll<br />
rsync.exe<br />
to be able to use rsync from the garden properly. I have no idea what happens if cygwin is in PATH, but it is asking for problems.<br />
<br />
<br />
<br />
== Cross-compiling on Mac OS X ==<br />
<br />
In order to cross-compile for PPC on a Intel Mac, you need to give the compiler and the linker the following additional switches:<br />
<br />
-arch ppc<br />
<br />
So all you have to do is set <code>CFLAGS</code> and <code>LDFLAGS</code> before you run <code>configure</code> (as well as <code>CXXFLAGS</code>, if applicable). Of course it may be that some Makefiles don't honor these variables and override them with something of their own, and this is the major inconvience you will have to deal with (this is actually what the Makefile for lua does; here you would have to set something like <code>MYCFLAGS</code> or <code>XCFLAGS</code> in addition).<br />
<br />
Obviously, you can also use a similar instruction to cross-compile the other way round (build for Intel on a PPC host); it's called <code>-arch i386</code>; and if you give both at the same time, it results with a so-called ''universal'' binary (the size of which being approximately the sum of the size of both individual binaries). [[User:Arthur|Arthur]] 17:20, 30 September 2007 (CEST)<br />
<br />
For pdfTeX it's enough to say<br />
CFLAGS="-arch ppc" LDFLAGS="-arch ppc" CXXFLAGS="-arch ppc" ./build.sh<br />
<br />
XeTeX supports the syntax<br />
./build-xetex "-arch ppc"<br />
for cross-compiling.<br />
<br />
It is also adviced to use<br />
gcc_select<br />
and select gcc 3.3 to be more backward compatible, as well as setting<br />
export MACOSX_DEPLOYMENT_TARGET=10.3<br />
<br />
== Compiling TeX Live binaries ==<br />
<br />
To compile 64-bit binaries on 10.6 or later:<br />
./Build --disable-xdvipdfmx --disable-xetex --disable-xdv2pdf<br />
To select the latest compiler on Lion:<br />
CC=clang OBJC=clang CXX=clang++ ./Build <options><br />
If we want to compile for 10.6 on 10.7 we additionally need:<br />
export MACOSX_DEPLOYMENT_TARGET=10.6<br />
# or add -mmacosx-version-min=10.6 to CFLAGS<br />
# most of the time optional; usually not needed, but one never knows<br />
export MYCFLAGS='-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk'<br />
export CC=llvm-gcc-4.2; export CFLAGS=$MYCFLAGS<br />
export OBJC=llvm-gcc-4.2; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=llvm-g++-4.2; export CXXFLAGS=$MYCFLAGS<br />
./Build <options><br />
<br />
To compile ppc and i386 binaries for Tiger on 10.6:<br />
export ARCH=i386<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-arch $ARCH -isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export LDFLAGS='-arch $ARCH'<br />
export CC=gcc-4.0; export CFLAGS=$MYCFLAGS<br />
export OBJC=gcc-4.0; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=g++-4.0; export CXXFLAGS=$MYCFLAGS<br />
<br />
Or alternatively:<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=i686-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=i686-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=i686-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=powerpc-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=powerpc-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=powerpc-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
= Non-Polish Fonts =<br />
<br />
== List of fonts in the old minimals ==<br />
<br />
=== already there ===<br />
<br />
* bluesky<br />
** ams<br />
* hoekwater<br />
** context/contnav (is it needed? it's in ConTeXt already)<br />
** mflogo<br />
** misc/manfnt<br />
* public<br />
** marvosym<br />
<br />
=== temporary there ===<br />
<i>These fonts will be removed once there will be TeX Gyre math available.</i><br />
<br />
* urw<br />
** helvetic<br />
** palatino<br />
** times<br />
* public<br />
** pxfonts<br />
** txfonts<br />
<br />
=== superseeded by TeX Gyre ===<br />
<br />
* urw<br />
** avantgar (Adobe AvantGarde) -> Adventor<br />
** bookman -> Bonum<br />
** courier -> Cursor<br />
** helvetic -> Heros<br />
** ncntrsbk (Adobe New Century Schoolbook) -> Schola<br />
** palatino -> Pagella<br />
** times -> Termes<br />
** zapfchan -> Chorus<br />
* public<br />
** qfonts<br />
<br />
=== may be removed ===<br />
<br />
* bluesky<br />
** cm<br />
* public<br />
** cs<br />
** pl<br />
<br />
=== sort them first ===<br />
<br />
* adobe/utopia<br />
* bitstream/charter<br />
* bluesky<br />
** ams - check<br />
** latex-fonts -?<br />
* public<br />
** antp -?<br />
** cb<br />
** cm-super<br />
** eulervm<br />
** fourier<br />
* urw<br />
** symbol<br />
** utopia<br />
** zapfding<br />
<br />
== Math support needed ==<br />
<br />
http://www.ctan.org/tex-archive/info/Free_Math_Font_Survey/en/survey.html<br />
<br />
* Helvetica<br />
* Times: tx (see type-enc) or belleek or symbol math or omega math<br />
* Palatino: px (or Pazo) or euler<br />
<br />
* Bookman: kerkis (check)<br />
* Schoolbook: millenial/fourerenc<br />
<br />
* cmbright<br />
* Concrete and Euler or Concrete Math<br />
<br />
forget-me-not (how to generate map files for XeTeX):<br />
ctxtools --dpx --force --maproot=/usr/local/gwTeX/texmf.pkgs/fonts/map/dvips/tex-gyre<br />
<br />
<br />
<br />
== Different (check) ==<br />
<br />
* wcm for syrillic<br />
* la/lb/lc rb1000 etc.<br />
* lhr<br />
* cbgreek<br />
<br />
* computer concrete (AMS) - see type-enc<br />
* euler (AMS)<br />
* AMS symbols<br />
* fourier<br />
<br />
* \definefontsynonym [RalfSmithFormalScript] [rsfs10]<br />
* \definefontsynonym [MartinVogel] [fmvr8x]<br />
<br />
== Building plain formats (to be done) ==<br />
<br />
''This text will disapear from page, but until we put some additional files to the distribution, here are some notes for me.''<br />
<br />
There are no CMR fonts in the distribution (more or less on purpose), but you can use LM replacement instead.<br />
<br />
% pdftex.ini<br />
\pdfoutput=1<br />
\pdfcompresslevel=9<br />
\pdfdecimaldigits=3<br />
\pdfpagewidth=210 true mm<br />
\pdfpageheight=297 true mm<br />
\pdfhorigin=1 true in<br />
\pdfvorigin=1 true in<br />
\pdfpkresolution=600<br />
<br />
\input plain<br />
\dump<br />
\endinput<br />
<br />
pdftex -ini pdftex.ini<br />
<br />
One needs to use:<br />
\pdfmapfile{+lm-rep-cmtext.map}<br />
'''Bold text'''<br />
<br />
[[Category:Standalone|Implementation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Humour&diff=19634Humour2012-06-08T14:25:46Z<p>Mojca Miklavec: wolfgang interface</p>
<hr />
<div>== A poem about documentation ==<br />
<br />
"Yet another context user" posted [http://archive.contextgarden.net/message/20100403.155801.7098c48a.en.html this poem] to the mailing list<br />
<br />
<pre><br />
If you were surprised, like me<br />
Fifty emails, in your inbox to see<br />
<br />
Let me help you with a summary<br />
Of what happended, using a poor excuse for poetry <br />
<br />
It was the day of fools<br />
When Arthur tried to be cool<br />
<br />
In ConTeXt mailing list he shouted, "Look<br />
I am going to write a ConTeXt book!"<br />
<br />
Everyone was happy and had a thrill<br />
Till Martin said, "it is the first of April"<br />
<br />
His joke ruined, Arthur was sad<br />
He said Martin, this is bad<br />
<br />
Other users were also upset, taken for a ride<br />
The lack of a book, is not a matter of pride<br />
<br />
There were cries and a big fuss<br />
I was just getting started, said Russ<br />
<br />
After that comments did pour<br />
Its not even funny, said Gour<br />
<br />
All of us would be out of luck<br />
If Hans were to be hit by a bus!<br />
<br />
Citing Douglas Adams said Taco<br />
That will make the bus, a shamed loco<br />
<br />
In time back it 'ill go<br />
And slam its breaks, like a pro<br />
<br />
Writing documentation is no fun<br />
It that the reason it is shun<br />
<br />
Even if you do write something<br />
Does anyone even read the damn thing?<br />
<br />
Taco lamented all he hears is that 'it sucks'<br />
Demotivated, he may just pass the buck<br />
<br />
"Oh please, don't let the project slack<br />
If you write something, we will give you feedback"<br />
<br />
This circle of arguments is always repeated<br />
Whenever the question of documentation gets tweeted<br />
<br />
A new conspiracy theory was added this time<br />
"They want to keep it a secret," it's a crime<br />
<br />
I am sick and tired of all the pretext<br />
Why do you think anyone should write a book on ConTeXt?<br />
<br />
Taco and Hans, their hands are full<br />
Everyone else is just using a tool<br />
<br />
(Actually when I was writing this chronology<br />
Irdis was thinking about a typographical ontology)<br />
<br />
If you think that the documentation is lacking<br />
Do something, rather than grumbling<br />
<br />
Here's a suggestion, if I may give to thee<br />
Follow it, and you'll be a ConTeXt prodigee<br />
<br />
Pick up a pen and go 'n write<br />
On any part of ConTeXt that you like<br />
<br />
A wiki article, a blog post, are good places to start<br />
People reading them will relish the knowledge it imparts<br />
<br />
Write an example, show how things work<br />
Don't just hide there and lurk<br />
<br />
If nothing else, write about what you find confusing<br />
Others writing documentation may find it motivating<br />
<br />
On this note, this summary I'll end<br />
You were not offended, I'll pretend<br />
<br />
Finally a request, if I may<br />
Let me be anonymous, please, I pray<br />
<br />
A promise in passing, I'll also make<br />
Someday a ConTeXt book or tutorial, I may bake<br />
<br />
I am waiting for time and a muse<br />
At least, that is my excuse<br />
<br />
<br />
<br />
-- A ConTeXt User<br />
<br />
<br />
</pre><br />
<br />
* Later in the thread Idris told how his name should be pronounced<br />
<pre><br />
&gt;&gt;&gt; (Actually when I was writing this chronology<br />
&gt;&gt;&gt; Irdis was thinking about a typographical ontology)<br />
&gt;&gt;<br />
&gt;&gt; Who is this Irdis?<br />
<br />
&gt; Oh, my heart now bleeds<br />
&gt; That I couldn't spell the name of Prof Hamid<br />
<br />
Our anonymous YACU ran, slipped and had to skid,<br />
Neither did (s)he know how to rhyme with Hamid<br />
<br />
Accent in Hamid is on the first syllable,<br />
Otherwise pronouncing it will be untenable<br />
</pre><br />
<br />
== What if Hans's were hit by a bus ==<br />
* Taco's brilliant [http://archive.contextgarden.net/message/20100403.065454.97ad25ba.en.html answer] to this question<br />
<br />
<pre><br />
&gt; This raises another concern and that is: what is the future of ConTeXt<br />
&gt; is Hans "get hit by the bus"? (Of course, we even do not want to think<br />
&gt; about it...)<br />
<br />
The answer to this question is quite obvious if you have read Douglas<br />
Adams' books: the bus will think about the impact of its actions on the<br />
universe for a moment. Then, deeply immersed in gut-wrenching shame,<br />
it will travel back in time half a minute and push its own breaks for<br />
an emergency stop.<br />
</pre><br />
<br />
== latex and LaTeX ==<br />
<br />
Taco Hoekwater [http://archive.contextgarden.net/message/20100911.100030.b6e30e98.en.html explaining] the similarity between latex and LaTeX<br />
<br />
<blockquote><br />
Creating beautiful latex garments is at least as challenging as creating beautiful LaTeX documents (I<br />
tried, in earlier days). And just like in LaTeX, the problem areas are glue control and insert<br />
placement. Selling latex garments is also similar to selling LaTeX books: it is quite a niche market and your clients are considered fetishists by most other people.<br />
</blockquote><br />
<br />
== ConTeXt logic ==<br />
<br />
Steffen Wolfrum [http://www.mail-archive.com/ntg-context@ntg.nl/msg22409.html bewildered] at ConTeXt syntax:<br />
<br />
<blockquote><br />
Sometimes ConTeXt's syntax looks kind of "female" to me:<br />
It certainly has an inner logic, but this is far more ... rich and varied as my <br />
single-minded, male structured mind would expect -)<br />
</blockquote><br />
<br />
== Where is my update? ==<br />
<br />
Vnpenguin was [http://www.mail-archive.com/ntg-context@ntg.nl/msg47711.html confused] why he was not able to update ConTeXt, until Hans resolved the mystery.<br />
<br />
<pre><br />
> Since one week, I update my minimal ConTeXt almost everyday (Win32<br />
> version), but the version is alway the same:<br />
<br />
sure, as i didn't update context for a week<br />
</pre><br />
<br />
== Can you run it for me? ==<br />
<br />
Peter Rolf asking R. Bastian [http://www.mail-archive.com/ntg-context@ntg.nl/msg49587.html not to be afraid]:<br />
<br />
<blockquote><br />
<p><br />
&gt; Does this work in Mk II ?<br />
</p><br />
<br />
<p><br />
You can set your mind at rest and test it yourself.<br />
The 'nuke_my_computer_by_running_context' module is no longer part of<br />
the official distribution ;-)<br />
</p><br />
</blockquote><br />
<br />
== Finite Life ==<br />
<br />
The following exchange between the Philosophers Ludovicus Scarso<br />
and Ioannes Hagenius could be observed on the mailing list[http://archive.contextgarden.net/message/20101218.131804.c250b741.en.html].<br />
<pre><br />
> Live is too short to learn all those languages and stay<br />
> fluent in them, i.e. one simply forgets a lot when usage zeros.<br />
we should start to think how to to become immortal.<br />
</pre><br />
<br />
== Installation chant ==<br />
<br />
Patrick shared this conversation on 2011-12-21:<br />
<pre><br />
Hello Marek,<br />
<br />
> Hi Mr. Gundla<br />
> Just want to say Im very dissapointed that no installing package of ConText exist. <br />
> I mean like you install things in Win – two cliks and Done!<br />
> I was studying ConText whole afternoon and i liked it – But – im very very sick of this kind of installing. <br />
> It just makes people like me to hate the whole thing about trying something else then MS Word. <br />
> I was eager to learn this ConText ant than BIIIIIIG! Frustration cause i could not run it. <br />
> All those versions of packages - i wanted to shoot myself.<br />
<br />
> Yea, i know you dont get paid for this, BUT - come on Mr. Gundla. <br />
> Is it that hard to make one ABSOLUTE DUMMY PACKAGE (you geeks can call it <br />
> how you want i know you like to use word dummies for people who are lesser geeks than you :) ) <br />
> two cliks and lalala! <br />
> Hello Word! You save afternoon to many other people :D Just think about it, ok?<br />
<br />
Well, ConTeXt _is_ hard to install. First you have to sacrifice one of your family members. <br />
Afterwards, you need to hum the magic chant in order to open your spirit. <br />
After you have done that, please draw a circle around your computer and put candles on it, making the shape of a pentagram. <br />
Now, and this is important, go six times clockwise around that circle, six times counter clockwise <br />
and then six times clockwise again. <br />
After that, turn on your computer and start your webbrowser and go to<br />
<br />
http://wiki.contextgarden.net/Simple_Windows_Installation<br />
<br />
and download the installer.<br />
<br />
Sincerely your Mr. Gundla<br />
</pre><br />
<br />
== Wolfgang Interface ==<br />
<br />
> Gosh this list is nice! Reminds me of the "good old days" when we<br />
> used UUCP, bang-paths and C-News to communicate (or the early<br />
> ARPANET days): polite, expert, very willing to share knowledge &c.<br />
<br />
Wolfgang is ConTeXt's natural language interface.<br />
<br />
In fact, with careful use of the filter module and a couple of mail<br />
programs, it should be possible to create something like:<br />
<texcode><br />
\usemodule[filter]<br />
<br />
\defineexternalfilter<br />
[wolfgang]<br />
[filtercommand={ ... code to send email and fetch reply ... },<br />
cache=yes]<br />
<br />
\startwolfgang<br />
Hello list,<br />
<br />
I wonder if anyone could tell me how to implement the following in<br />
ConTeXt.<br />
<br />
... description goes here ...<br />
\stopwolfgang<br />
</texcode><br />
It's important to include the cache=yes, so Wolfgang only has to reply<br />
once.<br />
<br />
= Comparison between various TeX and GUI systems =<br />
<br />
William Adam on the difference between [[Comparison_between_ConTeXt_and_other_typesetting_programs|TeX and other GUI document design systems]]<br />
<br />
= Pictures =<br />
<br />
== Future ConTeXt Users ==<br />
[[Future ConTeXt Users]]<br />
<br />
== Super Wolfgang ==<br />
<br />
A [http://meeting.contextgarden.net/2010/talks/2010-09-17-closing/wolfgang-color.jpg cartoon] by Duane Bibby at the Fourth ConTeXt meeting</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=ConTeXt_Standalone/Implementation&diff=19436ConTeXt Standalone/Implementation2012-05-23T16:56:10Z<p>Mojca Miklavec: how to cross-compile TeX Live on Mac OS X</p>
<hr />
<div>< [[ConTeXt Standalone]] | [[ConTeXt Standalone/Structure]] ><br />
<br />
<br />
Binaries can now be built from<br />
svn co http://svn.contextgarden.net/minimals-src/build-binaries<br />
It might take some time to propagate the changes and auto-update this page :)<br />
<br />
== Binary sources ==<br />
<br />
We take binaries from the following sources:<br />
<br />
=== MetaPost ===<br />
* SVN: http://foundry.supelec.fr/svn/metapost<br />
* ViewVC:http://foundry.supelec.fr/gf/project/metapost/scmsvn/<br />
* files: http://foundry.supelec.fr/gf/project/metapost/frs/<br />
<code>tags/XXX</code><br />
<br />
=== pdfTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/pdftex<br />
* VieVC: http://foundry.supelec.fr/gf/project/pdftex/scmsvn/<br />
<code>branches/stable/source</code><br />
<br />
=== luaTeX ===<br />
* SVN: http://foundry.supelec.fr/svn/luatex<br />
* ViewVC: http://foundry.supelec.fr/gf/project/luatex/scmsvn/<br />
* Files: http://foundry.supelec.fr/gf/project/luatex/frs/<br />
<code>tags/beta-XXX</code><br />
<br />
=== XeTeX ===<br />
* http://scripts.sil.org/svn-public/xetex/TRUNK<br />
<code>trunk</code><br />
<br />
=== TeX Live 2012 ===<br />
<br />
* http://www.tug.org/texlive/svn/<br />
<br />
== rsync ==<br />
<br />
Rsync on Windows behaves a bit weird. We fetched binaries from<br />
* http://www.itefix.no/cwrsync/<br />
One needs to set<br />
set CYGWIN=noNTsec<br />
before syncing binaries or<br />
chmod 777 tex/texmf-win/bin/*<br />
after that, else binaries won't work.<br />
<br />
From rsync bundle one needs to have at least<br />
chmod.exe<br />
cygiconv-2.dll # for chmod<br />
cygintl-3.dll # for chmod<br />
cygwin1.dll<br />
rsync.exe<br />
to be able to use rsync from the garden properly. I have no idea what happens if cygwin is in PATH, but it is asking for problems.<br />
<br />
<br />
<br />
== Cross-compiling on Mac OS X ==<br />
<br />
In order to cross-compile for PPC on a Intel Mac, you need to give the compiler and the linker the following additional switches:<br />
<br />
-arch ppc<br />
<br />
So all you have to do is set <code>CFLAGS</code> and <code>LDFLAGS</code> before you run <code>configure</code> (as well as <code>CXXFLAGS</code>, if applicable). Of course it may be that some Makefiles don't honor these variables and override them with something of their own, and this is the major inconvience you will have to deal with (this is actually what the Makefile for lua does; here you would have to set something like <code>MYCFLAGS</code> or <code>XCFLAGS</code> in addition).<br />
<br />
Obviously, you can also use a similar instruction to cross-compile the other way round (build for Intel on a PPC host); it's called <code>-arch i386</code>; and if you give both at the same time, it results with a so-called ''universal'' binary (the size of which being approximately the sum of the size of both individual binaries). [[User:Arthur|Arthur]] 17:20, 30 September 2007 (CEST)<br />
<br />
For pdfTeX it's enough to say<br />
CFLAGS="-arch ppc" LDFLAGS="-arch ppc" CXXFLAGS="-arch ppc" ./build.sh<br />
<br />
XeTeX supports the syntax<br />
./build-xetex "-arch ppc"<br />
for cross-compiling.<br />
<br />
It is also adviced to use<br />
gcc_select<br />
and select gcc 3.3 to be more backward compatible, as well as setting<br />
export MACOSX_DEPLOYMENT_TARGET=10.3<br />
<br />
== Compiling TeX Live binaries ==<br />
<br />
To compile 64-bit binaries on 10.6 or later:<br />
./Build --disable-xdvipdfmx --disable-xetex --disable-xdv2pdf<br />
To select the latest compiler on Lion:<br />
CC=clang OBJC=clang CXX=clang++ ./Build <options><br />
If we want to compile for 10.6 on 10.7 we additionally need:<br />
export MACOSX_DEPLOYMENT_TARGET=10.6<br />
# or add -mmacosx-version-min=10.6 to CFLAGS<br />
# most of the time optional; usually not needed, but one never knows<br />
export MYCFLAGS='-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk'<br />
export CC=llvm-gcc-4.2; export CFLAGS=$MYCFLAGS<br />
export OBJC=llvm-gcc-4.2; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=llvm-g++-4.2; export CXXFLAGS=$MYCFLAGS<br />
./Build <options><br />
<br />
To compile ppc and i386 binaries for Tiger on 10.6:<br />
export ARCH=i386<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-arch $ARCH -isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export LDFLAGS='-arch $ARCH'<br />
export CC=gcc-4.0; export CFLAGS=$MYCFLAGS<br />
export OBJC=gcc-4.0; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=g++-4.0; export CXXFLAGS=$MYCFLAGS<br />
<br />
Or alternatively:<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=i686-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=i686-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=i686-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
export MACOSX_DEPLOYMENT_TARGET=10.4<br />
export MYCFLAGS='-isysroot /Developer/SDKs/MacOSX10.4u.sdk'<br />
export CC=powerpc-apple-darwin10-gcc-4.0.1; export CFLAGS=$MYCFLAGS<br />
export OBJC=powerpc-apple-darwin10-gcc-4.0.1; export OBJCFLAGS=$MYCFLAGS<br />
export CXX=powerpc-apple-darwin10-g++-4.0.1; export CXXFLAGS=$MYCFLAGS<br />
<br />
= Non-Polish Fonts =<br />
<br />
== List of fonts in the old minimals ==<br />
<br />
=== already there ===<br />
<br />
* bluesky<br />
** ams<br />
* hoekwater<br />
** context/contnav (is it needed? it's in ConTeXt already)<br />
** mflogo<br />
** misc/manfnt<br />
* public<br />
** marvosym<br />
<br />
=== temporary there ===<br />
<i>These fonts will be removed once there will be TeX Gyre math available.</i><br />
<br />
* urw<br />
** helvetic<br />
** palatino<br />
** times<br />
* public<br />
** pxfonts<br />
** txfonts<br />
<br />
=== superseeded by TeX Gyre ===<br />
<br />
* urw<br />
** avantgar (Adobe AvantGarde) -> Adventor<br />
** bookman -> Bonum<br />
** courier -> Cursor<br />
** helvetic -> Heros<br />
** ncntrsbk (Adobe New Century Schoolbook) -> Schola<br />
** palatino -> Pagella<br />
** times -> Termes<br />
** zapfchan -> Chorus<br />
* public<br />
** qfonts<br />
<br />
=== may be removed ===<br />
<br />
* bluesky<br />
** cm<br />
* public<br />
** cs<br />
** pl<br />
<br />
=== sort them first ===<br />
<br />
* adobe/utopia<br />
* bitstream/charter<br />
* bluesky<br />
** ams - check<br />
** latex-fonts -?<br />
* public<br />
** antp -?<br />
** cb<br />
** cm-super<br />
** eulervm<br />
** fourier<br />
* urw<br />
** symbol<br />
** utopia<br />
** zapfding<br />
<br />
== Math support needed ==<br />
<br />
http://www.ctan.org/tex-archive/info/Free_Math_Font_Survey/en/survey.html<br />
<br />
* Helvetica<br />
* Times: tx (see type-enc) or belleek or symbol math or omega math<br />
* Palatino: px (or Pazo) or euler<br />
<br />
* Bookman: kerkis (check)<br />
* Schoolbook: millenial/fourerenc<br />
<br />
* cmbright<br />
* Concrete and Euler or Concrete Math<br />
<br />
forget-me-not (how to generate map files for XeTeX):<br />
ctxtools --dpx --force --maproot=/usr/local/gwTeX/texmf.pkgs/fonts/map/dvips/tex-gyre<br />
<br />
<br />
<br />
== Different (check) ==<br />
<br />
* wcm for syrillic<br />
* la/lb/lc rb1000 etc.<br />
* lhr<br />
* cbgreek<br />
<br />
* computer concrete (AMS) - see type-enc<br />
* euler (AMS)<br />
* AMS symbols<br />
* fourier<br />
<br />
* \definefontsynonym [RalfSmithFormalScript] [rsfs10]<br />
* \definefontsynonym [MartinVogel] [fmvr8x]<br />
<br />
== Building plain formats (to be done) ==<br />
<br />
''This text will disapear from page, but until we put some additional files to the distribution, here are some notes for me.''<br />
<br />
There are no CMR fonts in the distribution (more or less on purpose), but you can use LM replacement instead.<br />
<br />
% pdftex.ini<br />
\pdfoutput=1<br />
\pdfcompresslevel=9<br />
\pdfdecimaldigits=3<br />
\pdfpagewidth=210 true mm<br />
\pdfpageheight=297 true mm<br />
\pdfhorigin=1 true in<br />
\pdfvorigin=1 true in<br />
\pdfpkresolution=600<br />
<br />
\input plain<br />
\dump<br />
\endinput<br />
<br />
pdftex -ini pdftex.ini<br />
<br />
One needs to use:<br />
\pdfmapfile{+lm-rep-cmtext.map}<br />
'''Bold text'''<br />
<br />
[[Category:Standalone|Implementation]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Gnuplot&diff=19138Gnuplot2012-04-11T09:41:38Z<p>Mojca Miklavec: some updates (not yet finished)</p>
<hr />
<div>< [[Modules]] | [[Graphics]] | [[Math]] ><br />
<br />
http://www.gnuplot.info/figs/title2.png<br />
<br />
[http://www.gnuplot.info Gnuplot] is a portable command-line driven utility for function plotting for many platforms.<br />
<br />
To make the examples on this page work, you need Gnuplot 4.6.0 or later (or self-compiled binary).<br />
<br />
== Minimal Example ==<br />
<br />
<texcode><br />
\usemodule[gnuplot]<br />
<br />
% write a script for gnuplot<br />
\startGNUPLOTscript[sin]<br />
plot sin(x)<br />
\stopGNUPLOTscript<br />
<br />
% include the resulting graphic into the document<br />
\useGNUPLOTgraphic[sin]<br />
</texcode><br />
<br />
Calling gnuplot to create the graphic and postprocessing should happen automatically.<br />
<br />
== Requirements ==<br />
<br />
* '''[http://modules.contextgarden.net/gnuplot Gnuplot module]'''<br />
** in TeX Live you need to have <code>context-gnuplot</code> installed, in [[ConTeXt Standalone]] you can install it with <code>--modules=t-gnuplot</code> switch<br />
* '''Gnuplot has to be installed''' (and in your PATH)<br />
:On most Linux installations this is probably already the case. On Windows gnuplot.exe is usually also shipped and you need to make sure that it is in PATH. In case that the binary has a different name, you could create a file <code>gnuplot.bat</code> with something like:<br />
"C:\Program Files\gnuplot\bin\wgnupl32.exe" %*<br />
:(if that was the binary name) and put that file to a <i>"visible place"</i> (has to be found in PATH). Please note: if calling <code>gnuplot</code> from cmd works for you, there is no need to do anything extra.<br />
* '''[[write18]]''' has to be enabled<br />
=== To use the ConTeXt terminal (recommended) ===<br />
==== Windows ====<br />
You can fetch binaries from [http://sourceforge.net/projects/gnuplot/files/gnuplot/ sourceforge (released versions)] or from [http://www.tatsuromatsuoka.com/gnuplot/Eng/winbin/ Tatsuro Matsuoka (latest cvs version)].<br />
==== Unix or Mac ====<br />
The easiest way is to use version 4.6.0 or later shipped by your distribution. If that version is too old, you need to compile your own.<br />
<br />
If you want to use the version from trunk:<br />
# unofficial; you can also use official cvs<br />
git clone git://github.com/gnuplot/gnuplot.git<br />
./prepare<br />
./configure<br />
make<br />
make install<br />
I use <code>./configure --prefix=$PWD/inst</code> to avoid cluttering the system and install gnuplot to my personal directory. You can use other flags to configure for a different choice of GUI terminals.<br />
<br />
If you want to use the released version, get it from [http://sourceforge.net/projects/gnuplot/files/gnuplot/ sourceforge] and do the same, just skip the <code>./prepare</code>.<br />
<br />
The latest version of context terminal is available at http://github.com/mojca/gnuplot/raw/master/term/context.trm.<br />
<br />
Feel free to contact [[User:Mojca Miklavec|Mojca]] in case of problems.<br />
<br />
== Creating stand-alone, whole-page plots ==<br />
<br />
Here's an example of how to make a stand-alone ConTeXt document with one plot per page:<br />
<br />
set term context standalone size 15cm,10cm header '\usetypescript[iwona]' font 'iwona,ss' 10dd<br />
set output 'example.tex'<br />
plot ...<br />
<br />
== More complex example ==<br />
<br />
<texcode><br />
\usemodule[gnuplot]<br />
<br />
\setupGNUPLOT[terminal=tikz,option=color] % terminal=mp if you only have an old gnuplot at hand<br />
<br />
% general settings for the whole document<br />
\startGNUPLOTinclusions<br />
<br />
# you may use TeX commands to format the titles and axes<br />
set title '\bf Trigonometry'<br />
set xlabel '$x$'<br />
set ylabel '$y$'<br />
<br />
# to prevent uneven numbering: will result in<br />
# (0.0, 0.5, 1.0, 1.5, ...) instead of<br />
# (0, 0.5, 1, 1.5, ...)<br />
set format y '%.1f'<br />
\stopGNUPLOTinclusions<br />
<br />
\startGNUPLOTscript[tan]<br />
plot tan(x) t '$\tan(x)$'<br />
\stopGNUPLOTscript<br />
<br />
\startGNUPLOTscript[sin]<br />
plot 4*sin(x)+x t '$4\sin(x)+x$', x t '$x$' lt 3<br />
\stopGNUPLOTscript<br />
<br />
\useGNUPLOTgraphic[tan]<br />
\useGNUPLOTgraphic[sin][width=10cm]<br />
</texcode><br />
<br />
== Using other terminals ==<br />
<br />
<i>(Needs a revision.)</i><br />
<br />
Gnuplot support output in different formats with, for example<br />
set terminal mp color solid<br />
will output a metapost document with colors and without dashed lines. After some appropriate preprocessing (with [[MPtoPDF]] for this particular case) this file can be included in PDF documents.<br />
<br />
You can specify the terminal with<br />
<texcode><br />
\setupGNUPLOT[terminal=mp,options=color solid]<br />
</texcode><br />
<br />
* <code>terminal=</code> is mandatory since that't the only way to tell ConTeXt how to preprocess the file.<br />
* <code>options=</code> is optional and is appended to the end of <code>set terminal [terminal name]</code>. You can also override it by saying<br />
<texcode><br />
\startGNUPLOTinclusions<br />
set terminal mp color solid<br />
\stopGNUPLOTinclusions<br />
</texcode><br />
But you have to be careful that you don't set any other terminal with <code>output=</code> then.<br />
<br />
<!-- Another way to specify it is to override the terminal setting --><br />
<br />
Currently supported terminals are (attention: links not from the latest documentation):<br />
* [http://www.gnuplot.info/docs/gnuplot.html#mp mp/metapost]: uses [[MPtoPDF]] to convert images to pdf, but the context terminal should replace it<br />
* [http://www.gnuplot.info/docs/gnuplot.html#postscript_ ps/postscript]: most advanced in the number of supported features<br />
* [http://www.gnuplot.info/docs_4.0/gnuplot.html#png_%28NEW%29 png (1)],[http://www.gnuplot.info/docs_4.2/gnuplot.html#x1-41500051.53 png (2)]: outputs bitmap images (no preprocessing needed)<br />
* [http://www.gnuplot.info/docs_4.0/gnuplot.html#pdf pdf (old)],[http://www.gnuplot.info/docs_4.2/gnuplot.html#x1-41300051.51 pdf (new)]: outputs PDF directly for (no preprocessing needed), but is usually not available in most binaries of gnuplot<br />
* '''context''':<br />
<br />
The current gnuplot-documentation can be downloaded [http://www.gnuplot.info/docs_4.6/gnuplot.pdf here].<br />
<br />
== History ==<br />
<br />
I ([[User:Mojca Miklavec|Mojca Miklavec]]) probably mentioned long time ago that I would like to have (or write?) support for Gnuplot inside ConTeXt, but I had no knowledge to do that. Peter Münster posted the very first module for gnuplut support on the mailing list [http://article.gmane.org/gmane.comp.tex.context/24884], but that version only worked with bash. In the days to follow Hans Hagen has written a new module (based on my numerous "possible and impossible" requests) and Taco additionally provided some bugfixes and minor changes.<br />
<br />
The module provides an option to select the most appropriate/suitable driver according to the user's choice (metapost, png, pdf, postscript were the firs ones to be supported). Hans was wondering why there was no '''context terminal'''. I took over it's development, the code is almost finished by now, but I guess that Hans now regrets that question already.<br />
<br />
He had to invest quite some time into fixing buggy inclusion of text into graphics using <code>textext</code> (if nothing else, he had to read and reply to all the mails [complaints] that me and Taco sent him), just to lead to the conclusion that <code>textext</code> was useless for graphics produced by Gnuplot: too slow and TeX ran out of memory after 10 minutes while processing approximately the 13<sup>th</sup> plot. After that the new marvellous <code>\sometxt</code> command was born.<br />
<br />
I'm currently sticking tiny pieces together in the way I want the module to work. Hans could probably finish the same work that costs me a few days in a few minutes, but after dropping me a bone, he decided to leave me the joy of diving into ConTeXt internals and to let me figure out how to program in ConTeXt by myself. So I still keep spamming the mailing list with numerous questions and both Taco and Hans - without whom implementing the module would be impossible - keep answering.<br />
<br />
== Alternatives for Function Plotting ==<br />
<br />
* in [[MetaPost]]<br />
** [[source:m-graph.tex|m-graph]] Module (see [http://cm.bell-labs.com/who/hobby/cstr_164.pdf Drawing Graphs with MetaPost] by John D. Hobby)<br />
** functions in [[MetaFun]], see [[manual:metafun-s.pdf|metafun-s.pdf]], section 9.3<br />
* others<br />
** [http://pyx.sourceforge.net/ PyX] - graph drawing through python interface with TeX typesetting & PostScript capabilities<br />
** [http://theory.kitp.ucsb.edu/~paxton/tioga.html Tioga] - creating figures and plots using Ruby, PDF, and TeX<br />
** [http://comp.uark.edu/~luecking/tex/mfpic.html mfpic] - a scheme for producing pictures from LaTeX commands. The LaTeX commands generate a input file to be processed by Metapost.<br />
** [http://matplotlib.sourceforge.net matplotlib] - a Matlab-inspired Python based plotting tool which incorporates many features, including the use of TeX in labels, titles etc.<br />
** [http://tug.ctan.org/tex-archive/graphics/pgf/contrib/pgfplots/ pgfplots] - a TikZ-based LaTeX package for drawing graphs<br />
<br />
=== Other links ===<br />
* [http://tug.ctan.org/tex-archive/macros/latex/contrib/exceltex/ exceltex] - an interesting LaTeX package to get data from Excel into LaTeX<br />
<br />
[[Image:Slo Ministry of Higher Education Science and Technology.jpg]]<br />
<br />
[[Category:Modules]]<br />
[[Category:Graphics]]<br />
[[Category:Math]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/useURL&diff=18979Command/useURL2012-03-23T10:19:56Z<p>Mojca Miklavec: fix wrong syntax</p>
<hr />
<div>{{Reference<br />
|name=useURL<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\useURL<span class="first" >[...]</span><span class="second" >[...]</span><span class="third" >[...]</span><span class="first" >[...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...]</td><br />
<td>text </td><br />
</tr><br />
<tr valign="top" class="third"><br />
<td class="cmd">[...]</td><br />
<td>file </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>text </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
''name'' = label; usage in {{cmd|from}}[name];<br />
<br />
''text1'' = URL;<br />
<br />
''file'' = attached file URL;<br />
<br />
''text2'' = text.<br />
<br />
== comment ==<br />
Do not forget:<br />
* {{cmd|setupinteraction}} [state=start]<br />
also useful;<br />
* {{cmd|setupcolors}} [state=start]<br />
* {{cmd|setupurl}} [color=blue]<br />
<br />
== Example ==<br />
<br />
<context source='yes' text='yields'><br />
\setupinteraction [state=start]<br />
<br />
\setupcolors [state=start]<br />
\setupurl [color=blue]<br />
<br />
\setupinteraction [state=start,color=blue]<br />
\useURL<br />
[setposition]<br />
[http://source.contextgarden.net/tex/context/base/anch-pos.mkiv?search=from]<br />
[]<br />
[\tex{setposition}]<br />
<br />
\useURL<br />
[setuppositioning]<br />
[http://wiki.contextgarden.net/Category:Commands] <br />
[setuppositioning]<br />
[\tex{setuppositioning}]<br />
<br />
\starttext<br />
Lookup the source code of \from[setposition]!<br />
<br />
Or read about the syntax of \from[setuppositioning]. <br />
\stoptext<br />
</context><br />
<br />
== See also ==<br />
<!-- something like {{cmd|goto}} --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Interaction|useURL]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/useURL&diff=18978Command/useURL2012-03-23T10:16:36Z<p>Mojca Miklavec: Category Interaction and other tiny fixes</p>
<hr />
<div>{{Reference<br />
|name=useURL<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\useURL<span class="first" >[...]</span><span class="second" >[...]</span><span class="third" >[...]</span><span class="first" >[...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...]</td><br />
<td>text </td><br />
</tr><br />
<tr valign="top" class="third"><br />
<td class="cmd">[...]</td><br />
<td>file </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>text </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
''name'' = label; usage in {{cmd||from}}[name];<br />
<br />
''text1'' = URL;<br />
<br />
''file'' = attached file URL;<br />
<br />
''text2'' = text.<br />
<br />
== comment ==<br />
Do not forget:<br />
<texcode><br />
\setupinteraction [state=start]<br />
</texcode><br />
also useful;<br />
<texcode><br />
\setupcolors [state=start]<br />
\setupurl [color=blue]<br />
</texcode><br />
<br />
== Example ==<br />
<br />
<context source='yes' text='yields'><br />
\setupinteraction [state=start]<br />
<br />
\setupcolors [state=start]<br />
\setupurl [color=blue]<br />
<br />
\setupinteraction [state=start,color=blue]<br />
\useURL<br />
[setposition]<br />
[http://source.contextgarden.net/tex/context/base/anch-pos.mkiv?search=from]<br />
[]<br />
[\tex{setposition}]<br />
<br />
\useURL<br />
[setuppositioning]<br />
[http://wiki.contextgarden.net/Category:Commands] <br />
[setuppositioning]<br />
[\tex{setuppositioning}]<br />
<br />
\starttext<br />
Lookup the source code of \from[setposition]!<br />
<br />
Or read about the syntax of \from[setuppositioning]. <br />
\stoptext<br />
</context><br />
<br />
== See also ==<br />
<!-- something like {{cmd|goto}} --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Interaction|useURL]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/appendix&diff=18427Command/appendix2012-03-21T03:32:36Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=appendix<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\appendix<span class="first" style="color:red;">[ref,ref,...]</span><span class="second" >{...}</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[ref,ref,...]</td><br />
<td></td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Starts appendix part of a book.<br />
<br />
No longer exists in Mk IV. Instead use<br />
<br />
<texcode><br />
\startbodymatter<br />
\chapter{Regular chapter}<br />
% ...<br />
\stopbodymatter<br />
<br />
\startappendices<br />
\chapter{Appendix: Some stuff}<br />
% ...<br />
\stopappendices<br />
</texcode><br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|appendix]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/definehead&diff=18425Command/definehead2012-03-21T03:29:10Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=definehead<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\definehead<span class="first" >[...]</span><span class="second" >[...]</span><span class="third" >[...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>[[Command/value:IDENTIFIER|IDENTIFIER]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...]</td><br />
<td>[[Command/value:IDENTIFIER|IDENTIFIER]] </td><br />
</tr><br />
<tr valign="top" class="third"><br />
<td class="cmd">[...]</td><br />
<td>inherits from [[Command/setuphead|\setuphead]] </td><br />
</tr><br />
</table><br />
<br />
== Description == <br />
Used to define a new head (such as title, subject etc.). The idea is you can create a <tt>MySubject</tt> that derives it's defaults from <tt>subject</tt> and then customize MySubject without being concerned with overriding subject. Use with [[cmd:setuphead|\setuphead]].<br />
<br />
The first argument is the name of your new head. The second argument is the name of the head from which yours ought to be derived. The third (optional) argument is for options.<br />
<br />
Example: <br />
<br />
<texcode><br />
\definehead [Title] [title]<br />
\setuphead [Title]<br />
[textstyle=bfb,<br />
align=middle]<br />
</texcode><br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|definehead]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/placebookmarks&diff=18424Command/placebookmarks2012-03-21T03:27:50Z<p>Mojca Miklavec: add Category Command/Sections and Command/Interaction</p>
<hr />
<div>{{Reference<br />
|name=placebookmarks<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\placebookmarks<span class="first" style="color:red;">[...,...,...]</span><span class="second" style="color:red;">[...,...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...,...,...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...,...,...]</td><br />
<td>name all </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Creates bookmarks for the headers "section":<br />
<texcode><br />
\placebookmarks[section]<br />
</texcode><br />
<br />
Will do the same but open only chapter ones by default:<br />
<texcode><br />
\placebookmarks [chapter,section,subsection]<br />
[chapter]<br />
<br />
</texcode ><br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|placebookmarks]]<br />
[[Category:Command/Interaction|placebookmarks]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/definesection&diff=18423Command/definesection2012-03-21T03:26:14Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=definesection<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\definesection<span class="first" >[...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|definesection]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/definesectionblock&diff=18421Command/definesectionblock2012-03-21T03:24:10Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=definesectionblock<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\definesectionblock<span class="first" >[...]</span><span class="second" style="color:red;">[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...,...=...,...]</td><br />
<td>see [[Command/setupsectionblock|\setupsectionblock]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|definesectionblock]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/moveongrid&diff=18419Command/moveongrid2012-03-21T03:23:02Z<p>Mojca Miklavec: add Category Command/Grid Typesetting</p>
<hr />
<div>{{Reference<br />
|name=moveongrid<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\moveongrid<span class="first" style="color:red;">[...,...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...,...,...]</td><br />
<td>top both bottom -top -both -bottom text high middle low page none <strong>standard</strong> broad fit depth line dimension </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
[[cmd:placeongrid|\placeongrid]]<br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Grid Typesetting|moveongrid]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setupheads&diff=18416Command/setupheads2012-03-21T03:21:16Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=setupheads<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setupheads<span class="first" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:sectionnumber|sectionnumber]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:number|number]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:alternative|alternative]]</td><br />
<td>[[Command/value:normal|normal]] [[Command/value:margin|margin]] [[Command/value:middle|middle]] [[Command/value:text|text]] [[Command/value:paragraph|paragraph]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:separator|separator]]</td><br />
<td>[[Command/value:text|text]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:stopper|stopper]]</td><br />
<td>[[Command/value:text|text]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:align|align]]</td><br />
<td>[[Command/value:flushleft|flushleft]] [[Command/value:flushright|flushright]] [[Command/value:normal|normal]] [[Command/value:broad|broad]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:aligntitle|aligntitle]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:float|float]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:tolerance|tolerance]]</td><br />
<td>[[Command/value:verystrict|verystrict]] [[Command/value:strict|strict]] [[Command/value:tolerant|tolerant]] [[Command/value:verytolerant|verytolerant]] [[Command/value:stretch|stretch]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:indentnext|indentnext]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:command|command]]</td><br />
<td>[[Command/value:twoarguments|twoarguments]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:margin|margin]]</td><br />
<td>[[Command/value:dimension|dimension]] </td><br />
</tr><br />
</table><br />
<br />
== Description == <br />
Note that this command has been reported non-working for some people (but it seems to work fine for me).<br />
<br />
This command sets up the default options for all headings (e.g., the stuff generated by [[cmd:section|\section]], [[cmd:subsection|\subsection]], etc.). The [[cmd:setuphead|\setuphead]] command can be used to override these settings on a per-level basis (e.g., only for \section) and has some extra options as well.<br />
<br />
aligntitle=float causes the title to appear next to floats. By default, a title will be moved down to appear below a float, it will not be "wrapped" around a float like normal text. Setting this option causes it to wrap like normal text.<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|setupheads]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Sections&diff=18415Category:Command/Sections2012-03-21T03:20:03Z<p>Mojca Miklavec: Created page with "Sections"</p>
<hr />
<div>[[Category:Commands|Sections]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setupsection&diff=18414Command/setupsection2012-03-21T03:19:31Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=setupsection<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setupsection<span class="first" >[...]</span><span class="second" style="color:red;">[...]</span><span class="third" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="third"><br />
<td class="cmd">[[Command/keyword:conversion|conversion]]</td><br />
<td>[[Command/value:numbers|numbers]] [[Command/value:characters|characters]] [[Command/value:Characters|Characters]] [[Command/value:romannumerals|romannumerals]] [[Command/value:Romannumerals|Romannumerals]] </td><br />
</tr><br />
<tr valign="top" class="third"><br />
<td class="cmd">[[Command/keyword:previousnumber|previousnumber]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<br />
Suppose you want section numbers to appear as A, B, etc, then do<br />
<br />
<texcode><br />
\setuphead[section-3][bodypartconversion=Characters]<br />
</texcode ><br />
<br />
section-1 corresponds to [[cmd:part|\part]] <br /><br />
section-2 corresponds to [[cmd:chapter|\chapter]]<br /><br />
section-3 corresponds to [[cmd:section|\section]],<br /><br />
and so on<br />
<br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|setupsection]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setupsectionblock&diff=18413Command/setupsectionblock2012-03-21T03:19:05Z<p>Mojca Miklavec: add Category Command/Sections</p>
<hr />
<div>{{Reference<br />
|name=setupsectionblock<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setupsectionblock<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:number|number]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:page|page]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:right|right]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:before|before]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:after|after]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
Standard section blocks:<br />
* frontpart<br />
* bodypart<br />
* backpart<br />
* appendix<br />
<br />
{|Params|| ||<br />
|-<br />
| '''page'''||<tt>yes</tt> || start section block on a new page<br />
|-<br />
| ||<tt>right</tt> || start section block on a right (odd) page<br />
|}<br />
<br />
<br />
== Example ==<br />
<br />
<texcode><br />
\setupsectionblock[frontpart][page=no]<br />
\setupsectionblock[bodypart][page=no]<br />
\setupsectionblock[backpart][page=no]<br />
\setupsectionblock[appendix][page=no]<br />
</texcode><br />
<br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Sections|setupsectionblock]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Verbatim_Text&diff=18407Category:Command/Verbatim Text2012-03-21T03:13:25Z<p>Mojca Miklavec: Created page with "Verbatim Text"</p>
<hr />
<div>[[Category:Commands|Verbatim Text]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/definetype&diff=18406Command/definetype2012-03-21T03:12:31Z<p>Mojca Miklavec: add Category Command/Verbatim Text</p>
<hr />
<div>{{Reference<br />
|name=definetype<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\definetype<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...,...=...,...]</td><br />
<td>see [[Command/setuptype|\setuptype]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Verbatim Text|definetype]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/definetyping&diff=18405Command/definetyping2012-03-21T03:12:05Z<p>Mojca Miklavec: add Category Command/Verbatim Text</p>
<hr />
<div>{{Reference<br />
|name=definetyping<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\definetyping<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>file typing name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...,...=...,...]</td><br />
<td>see [[Command/setuptyping|\setuptyping]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Defines a new typing environment and the corresponding <tt>\start</tt> and <tt>\stop</tt> commands. The first argument is the name of the typing environment, the second argument are the options to apply for this environment.<br />
<br />
Note that difference with [[cmd:setuptyping|\setuptyping]]: [[cmd:definetyping|\definetyping]] defines a new typing environment, while [[cmd:setuptyping|\setuptyping]] changes the options of an existing typing environment (including the default environment that you get when using [[cmd:starttyping|\starttyping]]).<br />
<br />
<br />
<br />
<br />
== Example ==<br />
<br />
<texcode><br />
\definetyping<br />
[TTinput]<br />
[before={\startframedtext[width=\makeupwidth,<br />
background=screen,<br />
backgroundscreen=.8]},<br />
after={\stopframedtext}]<br />
\starttext<br />
\startTTinput<br />
test<br />
\stopTTinput<br />
\stoptext<br />
</texcode><br />
<br />
== See also ==<br />
[[cmd:setuptyping|\setuptyping]]<br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Verbatim Text|definetyping]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setuptype&diff=18404Command/setuptype2012-03-21T03:11:45Z<p>Mojca Miklavec: add Category Command/Verbatim Text</p>
<hr />
<div>{{Reference<br />
|name=setuptype<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setuptype<span class="first" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:space|space]]</td><br />
<td>[[Command/value:on|on]] [[Command/value:off|off]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:option|option]]</td><br />
<td>[[Command/value:slanted|slanted]] [[Command/value:normal|normal]] [[Command/value:none|none]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:style|style]]</td><br />
<td>[[Command/value:normal|normal]] [[Command/value:bold|bold]] [[Command/value:slanted|slanted]] [[Command/value:boldslanted|boldslanted]] [[Command/value:type|type]] [[Command/value:cap|cap]] [[Command/value:small|small]] ... [[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[[Command/keyword:color|color]]</td><br />
<td>[[Command/value:name|name]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Verbatim Text|setuptype]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setuptyping&diff=18403Command/setuptyping2012-03-21T03:11:24Z<p>Mojca Miklavec: add Category Command/Verbatim Text</p>
<hr />
<div>{{Reference<br />
|name=setuptyping<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setuptyping<span class="first" style="color:red;">[...]</span><span class="second" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>file typing name </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:space|space]]</td><br />
<td>[[Command/value:on|on]] [[Command/value:off|off]] [[Command/value:fixed|fixed]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:page|page]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:option|option]]</td><br />
<td>[[Command/value:slanted|slanted]] [[Command/value:normal|normal]] [[Command/value:commands|commands]] [[Command/value:color|color]] [[Command/value:none|none]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:text|text]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:icommand|icommand]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:vcommand|vcommand]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:ccommand|ccommand]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:before|before]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:after|after]]</td><br />
<td>[[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:margin|margin]]</td><br />
<td>[[Command/value:dimension|dimension]] [[Command/value:standard|standard]] [[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:evenmargin|evenmargin]]</td><br />
<td>[[Command/value:dimension|dimension]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:oddmargin|oddmargin]]</td><br />
<td>[[Command/value:dimension|dimension]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:blank|blank]]</td><br />
<td>[[Command/value:dimension|dimension]] [[Command/value:small|small]] [[Command/value:medium|medium]] [[Command/value:big|big]] [[Command/value:standard|standard]] [[Command/value:halfline|halfline]] [[Command/value:line|line]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:escape|escape]]</td><br />
<td>[[Command/value:character|character]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:tab|tab]]</td><br />
<td>[[Command/value:number|number]] [[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:indentnext|indentnext]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:style|style]]</td><br />
<td>[[Command/value:normal|normal]] [[Command/value:bold|bold]] [[Command/value:slanted|slanted]] [[Command/value:boldslanted|boldslanted]] [[Command/value:type|type]] [[Command/value:cap|cap]] [[Command/value:small...|small...]] [[Command/value:command|command]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:color|color]]</td><br />
<td>[[Command/value:name|name]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:palet|palet]]</td><br />
<td>[[Command/value:name|name]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:lines|lines]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:no|no]] [[Command/value:hyphenated|hyphenated]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:empty|empty]]</td><br />
<td>[[Command/value:yes|yes]] [[Command/value:all|all]] [[Command/value:no|no]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[[Command/keyword:numbering|numbering]]</td><br />
<td>[[Command/value:line|line]] [[Command/value:file|file]] [[Command/value:no|no]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Changes options for displaying verbatim text. When called with a single argument, this command changes the options for the default typing environment as created with [[cmd:starttyping|\starttyping]]. When the optional argument is given, it identifies a specific typing environment (as created with [[cmd:definetyping|\definetyping]]).<br />
<br />
[[cmd:setuptyping|\setuptyping]] can be used multiple times to change options and options will stay in effect until the end of file.<br />
<br />
Note that [[cmd:setuptyping|\setuptyping]] also affects the display of the [[cmd:typefile|\typefile]] command.<br />
<br />
* space<br />
** fixed: Lines will not be broken, even if too long (may cause "overfull hbox" message)<br />
<br />
* lines<br />
** no (default): no hyphenation<br />
** yes: no hyphenation and left aligned text (align key is ignored)<br />
** hyphenated: hyphenation<br />
<br />
== Example ==<br />
<br />
<texcode><br />
\setuptyping<br />
[before={\startframedtext[width=\makeupwidth,<br />
background=screen,<br />
backgroundscreen=.8]},<br />
after={\stopframedtext}]<br />
<br />
\starttext<br />
\starttyping<br />
test<br />
\stoptyping<br />
\stoptext<br />
</texcode><br />
<br />
<br />
== See also ==<br />
[[cmd:typefile|\typefile]], [[cmd:starttyping|\starttyping]], [[cmd:definetyping|\definetyping]]<br />
<br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Verbatim Text|setuptyping]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/fraction&diff=18396Command/fraction2012-03-21T02:48:27Z<p>Mojca Miklavec: remove setuppagenumbering after fixing configuration</p>
<hr />
<div>{{Reference<br />
|name=fraction<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\fraction<span class="first" >{...}</span><span class="second" >{...}</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Displays a fraction. In first bracket pair the numerator is set, in the second the denominator.<br />
<br />
== Example ==<br />
<texcode><br />
$\fraction{x^2}{k+1}$<br />
</texcode><br />
<br />
<context><br />
$\fraction{x^2}{k+1}$<br />
</context><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Mathematics|fraction]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/switchtobodyfont&diff=18395Command/switchtobodyfont2012-03-21T02:22:07Z<p>Mojca Miklavec: typo</p>
<hr />
<div>{{Reference<br />
|name=switchtobodyfont<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\switchtobodyfont<span class="first" >[...,...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...,...,...]</td><br />
<td>5pt ... 12pt small big global </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
Use [[cmd:setupbodyfont|\setupbodyfont]] to change the font size for whole document, [[cmd:switchtobodyfont|\switchtobodyfont]] doesn’t change the size for the header/footer.<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Fonts|switchtobodyfont]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/setupbodyfontenvironment&diff=18393Command/setupbodyfontenvironment2012-03-21T02:17:21Z<p>Mojca Miklavec: typo</p>
<hr />
<div>{{Reference<br />
|name=setupbodyfontenvironment<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\setupbodyfontenvironment<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...]</td><br />
<td>see [[Command/setupbodyfont|\setupbodyfont]] </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">[...,...=...,...]</td><br />
<td>see [[Command/setupbodyfont|\setupbodyfont]] </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
<br />
<br />
<br />
== Example ==<br />
<br />
<texcode><br />
\setupbodyfontenvironment<br />
[default][em=italic]<br />
<br />
\em defaults to slanted, this makes \em=\it<br />
</texcode><br />
<br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Fonts|setupbodyfontenvironment]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/useencoding&diff=18392Command/useencoding2012-03-21T02:15:41Z<p>Mojca Miklavec: typo</p>
<hr />
<div>{{Reference<br />
|name=useencoding<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\useencoding<span class="first" >[...,...,...]</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">[...,...,...]</td><br />
<td>name </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
This command is MKII-only. It loads support for one or more font encodings not already preloaded in the core. This is seldom needed (if ever).<br />
<br />
== Example ==<br />
ConTeXt core already uses:<br />
<texcode><br />
\useencoding[ans,il2,ec,tbo,pdf,pol,qx,t5,l7x,cyr,agr]<br />
</texcode><br />
<br />
If you had a need to use Cyrillic encoding t2c for example, you could use<br />
<texcode><br />
\useencoding[t2c]<br />
\usetypescript[antykwa-torunska][t2c]<br />
\setupbodyfont[antykwa-torunska]<br />
</texcode><br />
However t2c is already preloaded with enco-cyr.<br />
<br />
== See also ==<br />
[[cmd:usetypescript|\usetypescript]]<br />
[[cmd:startencoding|\startencoding]]<br />
[[cmd:definecharacter|\definecharacter]]<br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Fonts|useencoding]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/fraction&diff=18387Command/fraction2012-03-21T02:01:00Z<p>Mojca Miklavec: typeset example</p>
<hr />
<div>{{Reference<br />
|name=fraction<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\fraction<span class="first" >{...}</span><span class="second" >{...}</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Displays a fraction. In first bracket pair the numerator is set, in the second the denominator.<br />
<br />
== Example ==<br />
<texcode><br />
$\fraction{x^2}{k+1}$<br />
</texcode><br />
<br />
<context><br />
\setuppagenumbering[location=]<br />
$\fraction{x^2}{k+1}$<br />
</context><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Mathematics|fraction]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/fraction&diff=18386Command/fraction2012-03-21T01:59:29Z<p>Mojca Miklavec: add Category Mathematics</p>
<hr />
<div>{{Reference<br />
|name=fraction<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\fraction<span class="first" >{...}</span><span class="second" >{...}</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
<tr valign="top" class="second"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Displays a fraction. In first bracket pair the numerator is set, in the second the denominator.<br />
<br />
== Example ==<br />
<texcode><br />
$\fraction{x^2}{k+1}$<br />
</texcode><br />
<br />
<br />
<br />
== Example ==<br />
<!-- Please fill in an example if you can --><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Command/Mathematics|fraction]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Grid_Typesetting&diff=18380Category:Command/Grid Typesetting2012-03-21T01:47:41Z<p>Mojca Miklavec: category Commands</p>
<hr />
<div>{{todo|This Category probably belongs to Layouts/Paragraphs or something similar.}}<br />
[[Category:Commands|Grid Typesetting]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Command/mediaeval&diff=18374Command/mediaeval2012-03-21T01:36:28Z<p>Mojca Miklavec: add to Commands/Fonts</p>
<hr />
<div>{{Reference<br />
|name=mediaeval<br />
|attributes=<br />
}}<br />
<br />
== [[Help:Reference|Syntax]] ==<br />
<table cellspacing="4" cellpadding="2" class="cmd"><br />
<tr><br />
<td colspan="2" class="cmd">\mediaeval<span class="first" >{...}</span></td><br />
</tr><br />
<tr valign="top" class="first"><br />
<td class="cmd">{...}</td><br />
<td><i>text</i> </td><br />
</tr><br />
</table><br />
<br />
<br />
== Description == <br />
Renders numbers as "oldstyle" numbers (also called "mediaeval" or "lowercase" numbers).<br />
<br />
<br />
== Example ==<br />
<context source="yes" text="yields"><br />
\mediaeval{1234567890}<br />
</context><br />
<br />
== See also ==<br />
<!-- something like [[cmd:goto|\goto]] --><br />
<br />
== Help from ConTeXt-Mailinglist/Forum ==<br />
All issues with:<br />
{{Forum|{{SUBPAGENAME}}}}<br />
<br />
[[Category:Commands/Fonts|mediaeval]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Sorting&diff=18373Category:Command/Sorting2012-03-21T01:16:53Z<p>Mojca Miklavec: sorting order</p>
<hr />
<div>[[Category:Commands|Sorting]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Rules&diff=18371Category:Command/Rules2012-03-21T01:15:06Z<p>Mojca Miklavec: sorting order</p>
<hr />
<div>[[Category:Commands|Rules]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Texts&diff=18370Category:Command/Texts2012-03-21T01:14:08Z<p>Mojca Miklavec: sorting order</p>
<hr />
<div>[[Category:Commands|Texts]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Symbols&diff=18369Category:Symbols2012-03-21T01:13:19Z<p>Mojca Miklavec: fix broken link</p>
<hr />
<div>See also the ConTeXt-Commands: [[:Category:Command/Symbols|Category Symbols]].<br />
[[Category:ConTeXt-Issues]]</div>Mojca Miklavechttps://wiki.contextgarden.net/index.php?title=Category:Command/Symbols&diff=18368Category:Command/Symbols2012-03-21T01:12:38Z<p>Mojca Miklavec: sorting order</p>
<hr />
<div>See also [[:Category:Symbols]].<br />
[[Category:Commands|Symbols]]</div>Mojca Miklavec