For a couple of years now, TeXstudio is my favorite IWE (Integrated Writing Environment) for LaTeX. Last year, I switched from Windows to OS X, but I didn’t take my LaTeX environment with me. Since I’m going to need LaTeX more often in the next time, I finally set it up on OS X 10.11 El Capitan. Unfortunately, this was not an easy task. And here’s why:
Texshop El Capitan
The current distribution is MacTeX-2021 This distribution requires Mac OS 10.14, Mojave, or higher and runs natively on Intel and Arm processors. To download, click MacTeX Download. You can also install TeX Live 2021 using the TeX Live Unix Install Script. This method supports MacOS 10.6, Snow Leopard, and higher and runs on Intel and Arm processors. El Capitan導入後にしたこと. Homebrewのメンテナンス $ brew doctor を実行し，出てくる指示に従って，お掃除をした。 mactexの設定修正; いつもお世話になっている奥村先生のサイト情報にしたがって，以下を実行した。. Dear Taco, I thank you very much for your time. It works perfectly and I will emulate these modifications in my other figures. I have no ideas about the problem, I just figured out that it came from El Capitan because I updated the OS yesterday, however I also had to reinstall MacTex, so it may also come from a different version of ConText?
Installing MacTeX and TeXstudio
The most common TeX distribution on Mac is MacTeX, and this distribution is incredibly huge: MacTeX’s installation package is about 2.3 gigabytes in size. The distribution contains all important TeX binaries, Ghostscript and some GUI tools for managing packets or modifying global TeX settings. (There’s also a way smaller distribution called BasicTeX, whose package is only 109 megabytes in size. However, I haven’t tested this distribution in combination with TeXstudio.)
Okay, installing a package is easy so far. But after you have installed MacTeX and TeXstudio, you will find that TeXstudio reports that it’s not able to find a LaTeX distribution. Huh, why is that?
Keep Out, Super User!
“Don’t touch my system folders” — El Capitan
El Capitan’s all-new System Integrity Protection disallows modifying system folders such as /usr or /sbin even if you are granted super user rights. Those system folders can be modified with system rights only – for a good reason.
Hence, El Capitan doesn’t only prevent you from installing (linking) the binaries of MacTeX to the very common location of TeX distributions in /usr/texbin, it even breaks your existing installations of MacTeX if you upgrade from Yosemite or earlier versions of OS X to El Capitan.
TeXstudio looks for a tex distribution in the /usr/texbin folder only, and obviously won’t find it there. Therefore, you have to remap all commands usally found in /usr/texbin to the new location in /Library/TeX/texbin:
If you installed MacTeX and experience problems with the GUI or command line tools (or both) because of missing paths or binary files, make sure you execute the Setup-2015.pkg package in the TeX folder in Applications. This fixes the paths to the TeX distribution in Library.
Note: You can also perform those steps on versions of OS X prior to El Capitan. In this case your TeX environment will continue to work after upgrading to El Capitan.
Configuring TeXstudio for Git
Mactex El Capitan
Git is one of the most advanced version control systems around. However, TeXstudio only includes support for the older and less powerful Subversion (SVN). At the time of this writing, the feature request regarding Git support is more than four years old. But thanks to Git’s support for aliases, you can map SVN’s commit command ci to Git’s commit command (source):
git config --global alias.ci 'commit'
Finally, you have to set git as the command for SVN and SVNADMIN. Now you can enable automated commits to keep intermediate results of your progress.
If you have another IWE or use other tools that don’t find your MacTeX installation, make sure to check out this guide by Herbert Schultz about upgrading your TeX environment to El Capitan.
Et voilà! Your TeX environment on El Captian is up and running.
MacTeX | Donate | FAQ | Help | TUG
faq.html gettinghelp.html-->| To obtain the distribution, click the link below. | |||
| All install packages are developer-signed and notarized by Apple. | |||
| While downloading, please skim read the rest of the page. | |||
| Users who run into trouble often write us without noticing that the solution is on this very page. | |||
| MacTeX-2021 requires macOS 10.14, 10.15, or 11 | |||
| Mojave, Catalina, or Big Sur | |||
| and runs natively on both Arm and Intel machines. MacTeX.pkg [ approximately 4.4G - 29 March 2021] The MD5 sum is 327168dcc3036603eccce226cb7fadf9 The SHA256 sum is e541257d70f911550341853709fc45d9fa9fcd4c93058382000ebb19b284833b The SHA512 sum is 05d6e46347feb07bd9fed8ff1bfa855059a8fcf2c452fd832e0db1e15b5c171a2f86b5b911c37166dd19cfaba4f6e7fa4ea9f46c322f87f02f2b411bd1c54852 Download with Safari strongly recommended | |||
Installing MacTeX All binaries in MacTeX-2021 are universal, with code for both Arm and Intel processors. The same source code is used to compile both types of code, so Apple's Arm and Intel machines are on exactly the same footing. After downloading, move the file MacTeX.pkg to the desktop or another convenient spot,and double click it to install. Follow the straightforward instructions. Installation on a recent Macintoshtakes about ten minutes. When installation is complete, go to /Applications/TeX and read the documentREAD ME FIRST installed there, which explains how to find and use LaTeX. A copy of this document is availablehere. The installer presents a Welcome page. Then it presents a ReadMe page with more information.It presents a Software License page, and then a Final Page; clicking the 'Install' button on this page will start the actual installation. The final page also has a 'Customize' button, which leads to a panel allowing users to decide which pieces to install: Ghostscript, the Ghostscript Library, the GUI applications, and TeX Live itself. Most users will take the standard installation and ignore 'Customize'. Users who use MacPorts or HomeBrew may prefer to use the Ghostscript provided by these projects; if so they should use 'Customize' to disable Ghostscript installation. At the end of installation, the installer will report 'Success.' But sometimes, the installer puts up a dialog saying 'Verifying...' and then the install hangs. In all cases known to us, rebooting the Macintosh fixes this problem. After the reboot, install again. If other problems are reported during installation, skip to the section 'Installation Errors' below. MacTeX writes a symbolic link /Library/TeX/texbin which indirectly points to the TeX Live binary directory. Configure your GUI programs to use this link. The GUI programs we supply should automatically configure themselves. On older systems, you may have seen the link /usr/texbinwhich did the same thing. When Apple produced El Capitan, they modified the system so users could no longer write directly to the /usr directory and this rule remains in effect today. Therefore we replaced /usr/texbin with /Library/TeX/texbin. MacTeX installs TeX Live, the actual TeX Distribution, in /usr/local/texlive/2021, a location often hidden in the Finder. Typical users access TeX using a 'front end', a program providing an editor to enter TeX source and a preview window to view the typeset output. MacTeX installs the front end TeXShop in /Applications/TeX and most people will access TeX using that front end or a similar one. MacTeX installs a file called READ-ME-FIRST in ``/Applications/TeX/Docs and Spell Utilities'. This file explains how to start TeXShop and enter and then typeset a short sample document. MacTeX does not overwrite the TeX Distribution from the previous year. Users who run into trouble can switch to the previous distribution until the new distribution is fixed. Long ago we installed a Preference Pane which could do this switching, but this functionality is now in TeX Live Utility, which should be in /Applications/TeX. To switch, use the Configure menu item 'Select Default TeX Live Version.' MacTeX completely configures TeX, so after installationit is ready to use. Go to '/Applications/TeX/Docs and Spell Utilities/READ ME FIRST.pdf' and read this short document to get started. The location '/Applications/TeX/Docs and Spell Utilities/Documents' also contains 'What is installed', which lists all the components of MacTeX and their installation locations. MacTeX installs TeX Live, which contains TeX, LaTeX, AMS-TeX, and virtually every TeX-related style file and font. TeX Live is maintained by TeX User Groups across the world.TeX Live is compiled from the same sources for all platforms: Macintosh, Windows, Linux, Unix. MacTeX also installs the GUI programsTeXShop, LaTeXiT, TeX Live Utility, and BibDesk. MacTeX installs Ghostscript, an open source version of Postscript. An optional package installs libgs, the dynamical library for Ghostscript. That library is used by only one program in TeX Live, dvisvgm. So it is not installed by default, but can be obtained using the ``custom install' option in MacTeX. X11 is an open source windowing system using by Linux machines. Most Macintosh users can ignore it.An open source version of X11 called XQuartz is available for the Macintosh. It can be found here. If you use X11, you should update to the latest version of XQuartz, 2.8.0. This is particularly important for users with Arm machines. If you installed MacTeX before upgrading XQuartz, just install the Ghostscript piece again. The TeX Live programs xdvi, pdfopen, and pdfclose require X11. In addition, the Ghostscript library libgs requires X11 (but notice that dvisvgm is the only TeX Live program using it). Ghostscript comes with two binaries, gs-X11 and gs-noX11, where gs-X11 has support for X11 and gs-noX11 does not. When Ghostscript is first installed, a symbolic link named gs is created in /usr/local/bin. If X11 is present, gs points to gs-X11; otherwise it points to gs-noX11. On Arm machines, gs points to gs-X11 only if XQuartz 2.8.0 or higher is present. | |||
here In almost all cases, this error is caused by a faulty download. There is an easy way to check this. Go to /Applications/Utilities and run Terminal. Type
If you are having trouble downloading MacTeX, note that the download link points to a 'multiplexer' site which parcels out requests to various up-to-date CTAN mirrors. Occasionally users have trouble getting the package from this multiplexer. In that case, choose a specific mirror on this mirror page. If you are still unable to download MacTeX-2021 after trying several specific mirrors, and your md5 sum is always incorrect, there is almost nothing we can do to help. The TeX User Group does not run the distribution servers; they are maintained by an entirely separate organization called CTAN. Complaining to us that your download always fails is a waste of time. Updating Various Pieces After Installation A small number of users like to keep several versions of TeX Live available, even when they buy a new computer running the latest macOS. This is certainly possible because older versions of TeX Live continue to work on new systems, and versions containing only Intel code run fine on Arm machines. The old version can be installed on the new computer by copying it from an older machine, or byobtaining it from CTAN. For details, visit the web page . There is one complication. TeX Live Utility can update an old distribution to the version just before that version was retired. But this will fail for TeX Live 2019 or older versions, if installed on Big Sur or later versions of macOS. The reason is that TeX Live Utility calls the program tlmgr in the older distribution, and this program depends on various utilities in that older distribution. One of these utilities determines the operating system being run and expects a number starting with 10, like 10.5, 10.7, or 10.13. But Big Sur returns a number starting with 11. This bug was discovered and fixed in TeX Live 2020 within a week of the initial first beta of Big Sur in June, 2020, and thus long before the release of Big Sur to the public. But TUG does not fix bugs in older versions of TeX Live.Sometimes at the end of installation, the installer will report 'The installation failedThe Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance.'and a space. Then drag the install package icon 'MacTeX.pkg' and drop it on the Terminal window.Push RETURN. Terminal will print a message and then a long item with letters and numbers.Compare this number to the MD5 sum at the top of this page just under the MacTeX.pkg link.If the two numbers are different, your download was defective and you download again.If you downloaded with a third party browser, we recommend trying Safari for the new download.TeX Live 2021 and the various GUI programs installed by MacTeX are up to date as of April, 2021. But various pieces may have been updated since then. Each of our GUI programs has a menu item called 'Check for Updates.' Select this item to update the program to the current version. The TeX Live command line files are updated daily. To install these updates, use TeX Live Utility in /Applications/TeX.
|