\n\nIn many academic fields, you may find yourself needing to include a mathematical equation or other formula that requires special characters and formatting. Pressbooks currently supports LaTeX codes, which enables you to simply format these formulas and ensure that they will display correctly in all outputs. This chapter will cover:\n

Other solutions for equations and formulas<\/li>\n<\/ul>\n<\/div>\n

What is LaTeX?<\/h2>\nLaTeX is a programming language used for technical and scientific documents, but in small snippets, it can also be used to easily create formulas and equations in Pressbooks. Each character has its own code, and there are functions for common\u00a0formatting as well.\n\nIf you're familiar with regular expressions, it's similar in that it looks far more complicated than it is, and once you get the basics, you'll never look back. For example, here are a few character codes:\n\n\n\n\n\n\n\n

[latex]alpha[\/latex]<\/td>\n alpha<\/td>\n<\/tr>\n

[latex]beta[\/latex]<\/td>\n beta<\/td>\n<\/tr>\n

[latex]cos[\/latex]<\/td>\n cos<\/td>\n<\/tr>\n

[latex]leq[\/latex]<\/td>\n leq<\/td>\n<\/tr>\n

[latex]simeq[\/latex]<\/td>\n

simeq<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nAnd some of the\u00a0formatting options:\n\n\n\n\n\n

[latex]sqrt{abc}[\/latex]<\/td>\n sqrt{abc}<\/td>\n<\/tr>\n

[latex]frac{abc}{xyz}[\/latex]<\/td>\n frac{abc}{xyz}<\/td>\n<\/tr>\n

[latex]overleftarrow{abc}[\/latex]<\/td>\n

overleftarrow{abc}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nBy combining these character and formatting codes, you can create nearly any formula you can think of. Think of the process as having three elements:\n

The shortcode, which Pressbooks uses to translate LaTeX into a\u00a0properly formatted digital version of your formula<\/li>\n<\/ul>\n

How to Use LaTeX<\/h2>\nYou have two options for inputting LaTeX. You can either use PB LaTeX, or you can enable the QuickLaTeX plugin in order to type native LaTeX syntax directly into your chapters.\n

PB LaTeX<\/h3>\nInserting LaTeX into Pressbooks uses shortcodes to keep things simple. Shortcodes are like shortcuts that let you do some formatting with very little effort.\u00a0To add your formula to your book, you simply need to wrap it in the LaTeX shortcode shown\u00a0below, and insert it directly into your chapter, in the visual<\/strong> editor:\n $\"latex1\"$ \n
This will automatically convert your formula to a small image to preserve its formatting across exports.<\/p>\n
If you need to create your formula from scratch, you can use a\u00a0cheatsheet (we like\u00a0this one<\/a> from Brown University) and put together your code. As an\u00a0example, let's look at\u00a0Pythagoras' theorem:\u00a0[latex]a^2 + b^2 = c^2[\/latex]<\/p>\n
By using the cheatsheet, we can see that most of these characters can be typed in directly, and to get the\u00a0superscript for the 'squared' function, we just use ^ (on your keyboard). So our formula, when translated into LaTeX,\u00a0will look like this:<\/p>\n
a^2 + b^2 = c^2<\/p>\n
Then, when we wrap it in the LaTeX shortcode, it displays in outputs as:<\/p>\n
[latex]a^2 + b^2 = c^2[\/latex]<\/p>\n
For a more advanced example, let's say we want to use the truth function [latex][overline{p, xi}, N(xi)][\/latex].<\/p>\n
Using the cheatsheet again, we can find the code for the\u00a0special character, and the overline:<\/p>\n\n
\n \t
\u03be (xi) is xi<\/li>\n \t
To overline: overline{abc}<\/li>\n<\/ul>\n
Combined, the LaTeX version of the formula\u00a0looks like this:<\/p>\n
[overline{p, xi}, N(xi)]<\/p>\n
Finally, wrap it in the LaTeX shortcode and add it to your chapter in the visual editor: $\"latex2\"$ <\/p>\n
Which will display as:<\/p>\n
[latex][overline{p, xi}, N(xi)][\/latex]<\/p>\n
Other examples:<\/p>\n\n\n\n\n\n\n
\n
x^n + y^n = z^n<\/span><\/p>\n<\/td>\n
becomes<\/td>\n [latex]x^n + y^n = z^n[\/latex]<\/td>\n<\/tr>\n
x=frac{1+y}{1+2z^2}<\/td>\n becomes<\/td>\n \u00a0[latex]x=frac{1+y}{1+2z^2}[\/latex]<\/td>\n<\/tr>\n
int_0^infty e^{-x^2} dx=frac{sqrt{pi}}{2}<\/td>\n becomes<\/td>\n \u00a0[latex]int_0^infty e^{-x^2} dx=frac{sqrt{pi}}{2}[\/latex]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nNOTE:<\/strong> This function is currently more effective for\u00a0standalone formulas than in-text. In-text formulas will still display correctly, but may be slightly larger or smaller than your body text and won't be affected by other styling you have applied to your page.\n
Customizing\u00a0 PB LaTeX (Size & Color)<\/h3>\nThere are a couple of ways you can customize how your LaTeX formulas display. Some are controlled within your chapter editor, and others are set globally.\n\nFor the global settings, go to \"Settings\" --> \"PB LaTeX\" and you will see the screen shown below.\u00a0Here, you can:\n
\n \t
Check that LaTeX is working properly.<\/li>\n \t
See how to\u00a0use 'inline' syntax instead of shortcodes, if that is your preference.<\/li>\n \t
Set the default text color.<\/li>\n \t
Set the default background color.<\/li>\n<\/ul>\n[caption id=\"attachment_437\" align=\"alignnone\" width=\"1000\"] $\"PB$ PB LaTeX Screen[\/caption]\n\nYou can also control the LaTeX display using the shortcode itself. The first option is colour, where you can specify\u00a0a custom text and\/or background colour for when you don't want to apply these globally. To do so, add the following colour and\/or background setting to the opening shortcode:\n
$\"latex4\"$ <\/p>\n
The second option is size, which can range from tiny:<\/p>\n
[latex size=\"-4\"]a^2 + b^2 = c^2[\/latex]<\/p>\n
To very large:<\/p>\n
[latex size=\"4\"]a^2 + b^2 = c^2[\/latex]<\/p>\n
To control the sizing, add the 'size' setting\u00a0to the opening shortcode as follows:<\/p>\n
$\"latex5\"$ <\/p>\n
The size options range from -4 (the tiny version above) to 4 (the larger version above). These numbers correspond with the following LaTeX commands:<\/p>\n\n
-4 tiny\n -3 scriptsize\n -2 footnotesize\n -1 small\n 0 normalsize (12pt)\n 1 large\n 2 Large\n 3 LARGE\n 4 huge<\/code><\/pre>\nQuickLaTeX<\/h3>\nQuickLaTeX is a plugin that allows users to write native LaTeX syntax directly into their books.\n\nThis includes:\n\n \t$ ... $<\/li>\n \t [ ... ]<\/li>\n \t ( ... )<\/li>\n \t $ $ ... $ $<\/li>\n \t Environments: equation, align, displaymath, eqnarray, multline, flalign, gather, and alignat<\/li>\n<\/ul>\nIt also allows TikZ graphics support. Users can write TikZ commands directly in the post using begin{tikzpicture} ... end{tikzpicture}. QuickLaTeX will render them into image such that text on the picture and on the page will be of the same size.\n\u00a0NOTE:<\/strong> Enabling the QuickLaTeX plugin does not damage existing PB LaTeX. There is no need to change existing chapters that already use PB LaTeX shortcodes.<\/div>\nTo enable the QuickLaTeX plugin:\n\n \tGo to your book's dashboard<\/li>\n \t Click the Plugins<\/strong> tab on the left-hand menu of your screen<\/li>\n \t Scroll to WP QuickLaTeX<\/strong><\/li>\n \t Click Activate<\/strong><\/li>\n<\/ol>\nNOTE:<\/strong> QuickLaTeX must be enabled for each book; it can\u2019t be turned on for the entire network.<\/div>\n\n[caption id=\"attachment_437\" align=\"alignnone\" width=\"1916\"] Activating WP QuickLaTeX plugin[\/caption]\n\nOnce you\u2019ve enabled the QuickLaTeX plugin, you can activate QuickLaTeX on a chapter or part by inputting [latexpage] at the top of your visual or text editor. All typed LaTeX syntax after this shortcode will be converted into readable equations.\n\nUsing the same cheatsheet <\/a>from above, you can use native LaTeX syntax to create your desired equations:\n\n[caption id=\"attachment_437\" align=\"alignnone\" width=\"520\"] Example of QuickLaTex in a text editor[\/caption]\n\nThe above formulas above get converted into:\n\n[caption id=\"attachment_437\" align=\"alignnone\" width=\"520\"] Formulas converted from text to QuickLaTeX[\/caption]\nCustomizing QuickLaTeX<\/h3>\nTo customize your QuickLaTex, navigate to Settings > QuickLaTeX<\/strong> on the left-hand menu of your book's dashboard.\n\n[caption id=\"attachment_437\" align=\"alignnone\" width=\"1384\"] QuickLaTeX Settings Page[\/caption]\n\nFrom this page, you can click on the Basic Settings tab.\n<\/h2>\nYou can adjust font size, font color, and background color for your equations here. You can also choose whether you want your equations aligned left, right or center and whether you want the equation numbers aligned to the left or right.\n\nIf you\u2019d like to enable QuickLaTex for the entire book, you can click on the Advanced tab and toggle Use LaTeX Syntax Sitewide to ON. Then, click Update QuickLaTeX Settings. (NOTE<\/strong>: This ONLY applies to the book that you are on. Turning on this setting does not activate QuickLaTeX on the other books in your network.)\n<\/h2>\nOnce you\u2019ve turned on this setting, you no longer have to put [latexpage] at the top of each chapter or part that you want to include QuickLaTeX in. LaTeX syntax will automatically convert to proper images in all chapters and parts.\n\nYou can also, from this tab, choose to exclude the option for $ \u2026 $ syntax.\n\nFor more information on QuickLaTeX, visit the website for the plugin<\/a>.\nOther Uses for LaTeX<\/h2>\nLaTeX can also be used for individual special characters. While Pressbooks supports as wide a range of special characters as possible, it may be that you find a character you need displaying as a question mark in your outputs. To fix this, find the character code you need and wrap it in the latex shortcode.\nOther Solutions<\/h2>\nIf LaTeX is a bit much\u00a0for you, or you'd rather look at other options, you can always use special characters, symbols and the sub\/superscript buttons on the toolbar to compose your equations. These are well supported across web and ebook outputs, but in PDF can be a little patchy. We are working on\u00a0better\u00a0support for\u00a0this, but if you run into any trouble, email us at\u00a0support@pressbooks.com<\/a>\u00a0and we will look into it.\n\nIf you are fluent in HTML+CSS, you can also look at constructing and formatting your formulas that way.\nWatch This Space<\/h3>\nWe are currently working on expanding our support for mathematics and other special formatting for academic purposes. If you have any requests, recommendations or expertise to offer in this area, we welcome your input. Please email us at support@pressbooks.com<\/a>.\n\n \n\nPrefer to watch and learn? Here\u2019s a brief visual intro to using equations in Pressbooks.\n\nhttps:\/\/www.youtube.com\/watch?v=d9vNRQRnFPk","rendered":"\nIn many academic fields, you may find yourself needing to include a mathematical equation or other formula that requires special characters and formatting. Pressbooks currently supports LaTeX codes, which enables you to simply format these formulas and ensure that they will display correctly in all outputs. This chapter will cover:<\/p>\n \nWhat is LaTeX?<\/li>\n How to create a LaTeX code<\/li>\n Other uses for LaTeX<\/li>\n Other solutions for equations and formulas<\/li>\n<\/ul>\n<\/div>\nWhat is LaTeX?<\/h2>\nLaTeX is a programming language used for technical and scientific documents, but in small snippets, it can also be used to easily create formulas and equations in Pressbooks. Each character has its own code, and there are functions for common\u00a0formatting as well.<\/p>\n If you’re familiar with regular expressions, it’s similar in that it looks far more complicated than it is, and once you get the basics, you’ll never look back. For example, here are a few character codes:<\/p>\n\n\n\n\n\n\n\n<\/td>\n alpha<\/td>\n<\/tr>\n <\/td>\n beta<\/td>\n<\/tr>\n <\/td>\n cos<\/td>\n<\/tr>\n <\/td>\n leq<\/td>\n<\/tr>\n <\/td>\n simeq<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nAnd some of the\u00a0formatting options:<\/p>\n\n\n\n\n\n<\/td>\n sqrt{abc}<\/td>\n<\/tr>\n <\/td>\n frac{abc}{xyz}<\/td>\n<\/tr>\n <\/td>\n overleftarrow{abc}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nBy combining these character and formatting codes, you can create nearly any formula you can think of. Think of the process as having three elements:<\/p>\n \nYour\u00a0formula or equation<\/li>\n LaTeX, a language into which you translate your formula<\/li>\n The shortcode, which Pressbooks uses to translate LaTeX into a\u00a0properly formatted digital version of your formula<\/li>\n<\/ul>\nHow to Use LaTeX<\/h2>\nYou have two options for inputting LaTeX. You can either use PB LaTeX, or you can enable the QuickLaTeX plugin in order to type native LaTeX syntax directly into your chapters.<\/p>\n PB LaTeX<\/h3>\nInserting LaTeX into Pressbooks uses shortcodes to keep things simple. Shortcodes are like shortcuts that let you do some formatting with very little effort.\u00a0To add your formula to your book, you simply need to wrap it in the LaTeX shortcode shown\u00a0below, and insert it directly into your chapter, in the visual<\/strong> editor: \n<\/p>\n This will automatically convert your formula to a small image to preserve its formatting across exports.<\/p>\n If you need to create your formula from scratch, you can use a\u00a0cheatsheet (we like\u00a0this one<\/a> from Brown University) and put together your code. As an\u00a0example, let’s look at\u00a0Pythagoras’ theorem:\u00a0<\/p>\n By using the cheatsheet, we can see that most of these characters can be typed in directly, and to get the\u00a0superscript for the ‘squared’ function, we just use ^ (on your keyboard). So our formula, when translated into LaTeX,\u00a0will look like this:<\/p>\n a^2 + b^2 = c^2<\/p>\n Then, when we wrap it in the LaTeX shortcode, it displays in outputs as:<\/p>\n <\/p>\n For a more advanced example, let’s say we want to use the truth function .<\/p>\n Using the cheatsheet again, we can find the code for the\u00a0special character, and the overline:<\/p>\n \n\u03be (xi) is xi<\/li>\n To overline: overline{abc}<\/li>\n<\/ul>\nCombined, the LaTeX version of the formula\u00a0looks like this:<\/p>\n [overline{p, xi}, N(xi)]<\/p>\n Finally, wrap it in the LaTeX shortcode and add it to your chapter in the visual editor:<\/p>\n Which will display as:<\/p>\n <\/p>\n Other examples:<\/p>\n\n\n\n\n\n\nx^n + y^n = z^n<\/span><\/p>\n<\/td>\n becomes<\/td>\n <\/td>\n<\/tr>\n x=frac{1+y}{1+2z^2}<\/td>\n becomes<\/td>\n \u00a0<\/td>\n<\/tr>\n int_0^infty e^{-x^2} dx=frac{sqrt{pi}}{2}<\/td>\n becomes<\/td>\n \u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nNOTE:<\/strong> This function is currently more effective for\u00a0standalone formulas than in-text. In-text formulas will still display correctly, but may be slightly larger or smaller than your body text and won’t be affected by other styling you have applied to your page.<\/p>\n Customizing\u00a0 PB LaTeX (Size & Color)<\/h3>\nThere are a couple of ways you can customize how your LaTeX formulas display. Some are controlled within your chapter editor, and others are set globally.<\/p>\n For the global settings, go to “Settings” –> “PB LaTeX” and you will see the screen shown below.\u00a0Here, you can:<\/p>\n \nCheck that LaTeX is working properly.<\/li>\n See how to\u00a0use ‘inline’ syntax instead of shortcodes, if that is your preference.<\/li>\n Set the default text color.<\/li>\n Set the default background color.<\/li>\n<\/ul>\n<\/p>\nPB LaTeX Screen<\/p>\n<\/div>\n You can also control the LaTeX display using the shortcode itself. The first option is colour, where you can specify\u00a0a custom text and\/or background colour for when you don’t want to apply these globally. To do so, add the following colour and\/or background setting to the opening shortcode:<\/p>\n <\/div>\nThe second option is size, which can range from tiny:<\/p>\n <\/p>\n To very large:<\/p>\n <\/p>\n To control the sizing, add the ‘size’ setting\u00a0to the opening shortcode as follows:<\/p>\n <\/div>\nThe size options range from -4 (the tiny version above) to 4 (the larger version above). These numbers correspond with the following LaTeX commands:<\/p>\n -4 tiny\n -3 scriptsize\n -2 footnotesize\n -1 small\n 0 normalsize (12pt)\n 1 large\n 2 Large\n 3 LARGE\n 4 huge<\/code><\/pre>\nQuickLaTeX<\/h3>\nQuickLaTeX is a plugin that allows users to write native LaTeX syntax directly into their books.<\/p>\n This includes:<\/p>\n \n<\/li>\n [ … ]<\/li>\n ( … )<\/li>\n … <\/li>\n Environments: equation, align, displaymath, eqnarray, multline, flalign, gather, and alignat<\/li>\n<\/ul>\nIt also allows TikZ graphics support. Users can write TikZ commands directly in the post using begin{tikzpicture} … end{tikzpicture}. QuickLaTeX will render them into image such that text on the picture and on the page will be of the same size.<\/p>\n \u00a0NOTE:<\/strong> Enabling the QuickLaTeX plugin does not damage existing PB LaTeX. There is no need to change existing chapters that already use PB LaTeX shortcodes.<\/div>\nTo enable the QuickLaTeX plugin:<\/p>\n \nGo to your book’s dashboard<\/li>\n Click the Plugins<\/strong> tab on the left-hand menu of your screen<\/li>\n Scroll to WP QuickLaTeX<\/strong><\/li>\n Click Activate<\/strong><\/li>\n<\/ol>\nNOTE:<\/strong> QuickLaTeX must be enabled for each book; it can\u2019t be turned on for the entire network.<\/div>\n<\/p>\nActivating WP QuickLaTeX plugin<\/p>\n<\/div>\n Once you\u2019ve enabled the QuickLaTeX plugin, you can activate QuickLaTeX on a chapter or part by inputting at the top of your visual or text editor. All typed LaTeX syntax after this shortcode will be converted into readable equations.<\/p>\n Using the same cheatsheet <\/a>from above, you can use native LaTeX syntax to create your desired equations:<\/p>\n <\/p>\nExample of QuickLaTex in a text editor<\/p>\n<\/div>\n The above formulas above get converted into:<\/p>\n<\/p>\nFormulas converted from text to QuickLaTeX<\/p>\n<\/div>\nCustomizing QuickLaTeX<\/h3>\nTo customize your QuickLaTex, navigate to Settings > QuickLaTeX<\/strong> on the left-hand menu of your book’s dashboard.<\/p>\n<\/p>\nQuickLaTeX Settings Page<\/p>\n<\/div>\n From this page, you can click on the Basic Settings tab.<\/p>\n <\/h2>\nYou can adjust font size, font color, and background color for your equations here. You can also choose whether you want your equations aligned left, right or center and whether you want the equation numbers aligned to the left or right.<\/p>\n If you\u2019d like to enable QuickLaTex for the entire book, you can click on the Advanced tab and toggle Use LaTeX Syntax Sitewide to ON. Then, click Update QuickLaTeX Settings. (NOTE<\/strong>: This ONLY applies to the book that you are on. Turning on this setting does not activate QuickLaTeX on the other books in your network.)<\/p>\n<\/h2>\nOnce you\u2019ve turned on this setting, you no longer have to put at the top of each chapter or part that you want to include QuickLaTeX in. LaTeX syntax will automatically convert to proper images in all chapters and parts.<\/p>\n You can also, from this tab, choose to exclude the option for syntax.<\/p>\nFor more information on QuickLaTeX, visit the website for the plugin<\/a>.<\/p>\n Other Uses for LaTeX<\/h2>\nLaTeX can also be used for individual special characters. While Pressbooks supports as wide a range of special characters as possible, it may be that you find a character you need displaying as a question mark in your outputs. To fix this, find the character code you need and wrap it in the latex shortcode.<\/p>\nOther Solutions<\/h2>\nIf LaTeX is a bit much\u00a0for you, or you’d rather look at other options, you can always use special characters, symbols and the sub\/superscript buttons on the toolbar to compose your equations. These are well supported across web and ebook outputs, but in PDF can be a little patchy. We are working on\u00a0better\u00a0support for\u00a0this, but if you run into any trouble, email us at\u00a0support@pressbooks.com<\/a>\u00a0and we will look into it.<\/p>\n If you are fluent in HTML+CSS, you can also look at constructing and formatting your formulas that way.<\/p>\n Watch This Space<\/h3>\nWe are currently working on expanding our support for mathematics and other special formatting for academic purposes. If you have any requests, recommendations or expertise to offer in this area, we welcome your input. Please email us at support@pressbooks.com<\/a>.<\/p>\n \nPrefer to watch and learn? Here\u2019s a brief visual intro to using equations in Pressbooks.<\/p>\n <\/iframe><\/p>\n","protected":false},"author":1,"menu_order":11,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":"cc-by"},"chapter-type":[],"contributor":[],"license":[50],"part":377,"_links":{"self":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/440"}],"collection":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":2,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/440\/revisions"}],"predecessor-version":[{"id":442,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/440\/revisions\/442"}],"part":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/parts\/377"}],"metadata":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/440\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/media?parent=440"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapter-type?post=440"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/contributor?post=440"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/license?post=440"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}