Skip to content

Commit

Permalink
Build (be14cda): Finished cheatsheet; adding resources page
Browse files Browse the repository at this point in the history
  • Loading branch information
emprice committed Aug 16, 2023
1 parent a515fc7 commit 3c8e2a0
Show file tree
Hide file tree
Showing 12 changed files with 17 additions and 11 deletions.
2 changes: 1 addition & 1 deletion assets/styles-main.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion assets/styles-tutorial.css

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion index.html
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<!doctype html><html class="no-js" lang="en" data-theme="dark"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="ie=edge"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>elucidate</title><base href="/elucidate/"><link href="/elucidate/assets/styles-main.css" rel="stylesheet"></head><body><div id="sticky-container" data-sticky-container><div id="title" class="sticky title-bar show-for-small-only" data-sticky data-margin-top="0"><div class="title-bar-left"><span class="title-bar-title">elucidate</span></div><div class="title-bar-right"><button type="button" class="primary button" id="menu-button" data-toggle="menu-wrapper">Menu</button></div></div></div><div id="page-wrapper-outer"><div id="page-wrapper-inner"><div id="menu-wrapper" class="off-canvas" data-off-canvas data-close-on-click="true" data-in-canvas-on="medium"><div id="menu"><span class="hide-for-small-only menu-title">elucidate</span><ul id="controls"><li><label id="font-size-label" for="font-size-thumb">Font size multiplier</label><div id="font-size-control" class="slider" data-slider data-initial-start="1.1" data-start="0.6" data-end="2.6" data-step="0.1"><span id="font-size-thumb" aria-labelledby="font-size-label" class="slider-handle" data-slider-handle role="slider" tabindex="0"></span> <span class="slider-fill" data-slider-fill role="presentation"></span> <input type="hidden" id="font-size-input"></div></li><li><label id="dark-mode-label" for="dark-mode-switch">Toggle dark mode</label><div class="switch" id="dark-mode-control"><input class="switch-input" id="dark-mode-switch" aria-labelledby="dark-mode-label" type="checkbox"> <label class="switch-paddle" for="dark-mode-switch"></label></div></li></ul><div id="nav"><label id="nav-label" for="nav-drilldown">Navigate</label><ul id="nav-drilldown" class="vertical menu drilldown" data-drilldown data-back-button="&lt;li class&#x3D;&quot;js-drilldown-back&quot;&gt;&lt;a tabindex&#x3D;&quot;0&quot;&gt;&lt;i&gt;(back)&lt;/i&gt;&lt;/a&gt;&lt;/li&gt;"><li><a href="index.html">Project index</a></li><li class="is-drilldown-submenu-parent"><a href="#">HTML tutorial</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tutorial/index.html">Tutorial index</a></li><li><a href="tutorial/basic.html">Basic HTML syntax</a></li><li><a href="tutorial/skeleton.html">Simple HTML skeleton</a></li><li><a href="tutorial/cheatsheet.html">LaTeX to HTML cheatsheet</a></li></ul></li><li class="is-drilldown-submenu-parent"><a href="#">Toolbox</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tools/index.html">Tools index</a></li><li><a href="tools/mathml.html">LaTeX to MathML</a></li><li><a href="tools/colormap.html">Colormap designer</a></li></ul></li></ul></div></div></div><div id="body" class="off-canvas-content" data-off-canvas-content><div class="logo"><img class="show-for-light-only" src="assets/images-elucidate_light.svg"/> <img class="show-for-dark-only" src="assets/images-elucidate_dark.svg"/></div><div class="callout note"><div class="title md-note"></div><p>This project is still under construction and will need revisions and edits in the future. Treat it as a living document, with the understanding that the authors are learning about this topic for the first time, too. If you see a problem or want to give feedback, head over to <a href="https://github.com/emprice/elucidate">the GitHub page</a> and create an issue or pull request.</p></div></div></div></div><script defer="defer" src="/elucidate/assets/common-main~toolbox~mathml~colormap~tutorial.js"></script><script defer="defer" src="/elucidate/assets/main.bundle.js"></script></body></html>
<!doctype html><html class="no-js" lang="en" data-theme="dark"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="ie=edge"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>elucidate</title><base href="/elucidate/"><link href="/elucidate/assets/styles-main.css" rel="stylesheet"></head><body><div id="sticky-container" data-sticky-container><div id="title" class="sticky title-bar show-for-small-only" data-sticky data-margin-top="0"><div class="title-bar-left"><span class="title-bar-title">elucidate</span></div><div class="title-bar-right"><button type="button" class="primary button" id="menu-button" data-toggle="menu-wrapper">Menu</button></div></div></div><div id="page-wrapper-outer"><div id="page-wrapper-inner"><div id="menu-wrapper" class="off-canvas" data-off-canvas data-close-on-click="true" data-in-canvas-on="medium"><div id="menu"><span class="hide-for-small-only menu-title">elucidate</span><ul id="controls"><li><label id="font-size-label" for="font-size-thumb">Font size multiplier</label><div id="font-size-control" class="slider" data-slider data-initial-start="1.1" data-start="0.6" data-end="2.6" data-step="0.1"><span id="font-size-thumb" aria-labelledby="font-size-label" class="slider-handle" data-slider-handle role="slider" tabindex="0"></span> <span class="slider-fill" data-slider-fill role="presentation"></span> <input type="hidden" id="font-size-input"></div></li><li><label id="dark-mode-label" for="dark-mode-switch">Toggle dark mode</label><div class="switch" id="dark-mode-control"><input class="switch-input" id="dark-mode-switch" aria-labelledby="dark-mode-label" type="checkbox"> <label class="switch-paddle" for="dark-mode-switch"></label></div></li></ul><div id="nav"><label id="nav-label" for="nav-drilldown">Navigate</label><ul id="nav-drilldown" class="vertical menu drilldown" data-drilldown data-back-button="&lt;li class&#x3D;&quot;js-drilldown-back&quot;&gt;&lt;a tabindex&#x3D;&quot;0&quot;&gt;&lt;i&gt;(back)&lt;/i&gt;&lt;/a&gt;&lt;/li&gt;"><li><a href="index.html">Project index</a></li><li class="is-drilldown-submenu-parent"><a href="#">HTML tutorial</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tutorial/index.html">Tutorial index</a></li><li><a href="tutorial/basic.html">Basic HTML syntax</a></li><li><a href="tutorial/skeleton.html">Simple HTML skeleton</a></li><li><a href="tutorial/cheatsheet.html">LaTeX to HTML cheatsheet</a></li><li><a href="tutorial/resources.html">Resources</a></li></ul></li><li class="is-drilldown-submenu-parent"><a href="#">Toolbox</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tools/index.html">Tools index</a></li><li><a href="tools/mathml.html">LaTeX to MathML</a></li><li><a href="tools/colormap.html">Colormap designer</a></li></ul></li></ul></div></div></div><div id="body" class="off-canvas-content" data-off-canvas-content><div class="logo"><img class="show-for-light-only" src="assets/images-elucidate_light.svg"/> <img class="show-for-dark-only" src="assets/images-elucidate_dark.svg"/></div><div class="callout note"><div class="title md-note"></div><p>This project is still under construction and will need revisions and edits in the future. Treat it as a living document, with the understanding that the authors are learning about this topic for the first time, too. If you see a problem or want to give feedback, head over to <a href="https://github.com/emprice/elucidate">the GitHub page</a> and create an issue or pull request.</p></div></div></div></div><script defer="defer" src="/elucidate/assets/common-main~toolbox~mathml~colormap~tutorial.js"></script><script defer="defer" src="/elucidate/assets/main.bundle.js"></script></body></html>
1 change: 1 addition & 0 deletions motivation.html
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!doctype html><html class="no-js" lang="en" data-theme="dark"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="ie=edge"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>elucidate</title><base href="/elucidate/"><link href="/elucidate/assets/styles-main.css" rel="stylesheet"></head><body><div id="sticky-container" data-sticky-container><div id="title" class="sticky title-bar show-for-small-only" data-sticky data-margin-top="0"><div class="title-bar-left"><span class="title-bar-title">elucidate</span></div><div class="title-bar-right"><button type="button" class="primary button" id="menu-button" data-toggle="menu-wrapper">Menu</button></div></div></div><div id="page-wrapper-outer"><div id="page-wrapper-inner"><div id="menu-wrapper" class="off-canvas" data-off-canvas data-close-on-click="true" data-in-canvas-on="medium"><div id="menu"><span class="hide-for-small-only menu-title">elucidate</span><ul id="controls"><li><label id="font-size-label" for="font-size-thumb">Font size multiplier</label><div id="font-size-control" class="slider" data-slider data-initial-start="1.1" data-start="0.6" data-end="2.6" data-step="0.1"><span id="font-size-thumb" aria-labelledby="font-size-label" class="slider-handle" data-slider-handle role="slider" tabindex="0"></span> <span class="slider-fill" data-slider-fill role="presentation"></span> <input type="hidden" id="font-size-input"></div></li><li><label id="dark-mode-label" for="dark-mode-switch">Toggle dark mode</label><div class="switch" id="dark-mode-control"><input class="switch-input" id="dark-mode-switch" aria-labelledby="dark-mode-label" type="checkbox"> <label class="switch-paddle" for="dark-mode-switch"></label></div></li></ul><div id="nav"><label id="nav-label" for="nav-drilldown">Navigate</label><ul id="nav-drilldown" class="vertical menu drilldown" data-drilldown data-back-button="&lt;li class&#x3D;&quot;js-drilldown-back&quot;&gt;&lt;a tabindex&#x3D;&quot;0&quot;&gt;&lt;i&gt;(back)&lt;/i&gt;&lt;/a&gt;&lt;/li&gt;"><li><a href="index.html">Project index</a></li><li class="is-drilldown-submenu-parent"><a href="#">HTML tutorial</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tutorial/index.html">Tutorial index</a></li><li><a href="tutorial/basic.html">Basic HTML syntax</a></li><li><a href="tutorial/skeleton.html">Simple HTML skeleton</a></li><li><a href="tutorial/cheatsheet.html">LaTeX to HTML cheatsheet</a></li><li><a href="tutorial/resources.html">Resources</a></li></ul></li><li class="is-drilldown-submenu-parent"><a href="#">Toolbox</a><ul class="vertical menu nested is-drilldown-submenu invisible"><li><a href="tools/index.html">Tools index</a></li><li><a href="tools/mathml.html">LaTeX to MathML</a></li><li><a href="tools/colormap.html">Colormap designer</a></li></ul></li></ul></div></div></div><div id="body" class="off-canvas-content" data-off-canvas-content><h1>Motivation</h1><h2>Why not PDF?</h2><p>PDF (Portable Document Format) has arguably become the <i>de facto</i> standard in academic publishing. There are many reasons one could imagine that this became the case.</p><ul><li><p>PDF documents "look" nice. Electronically-typeset PDFs usually have nice vectorized fonts that scale with infinite resolution.</p></li><li><p>Furthermore, PDFs typeset with LaTeX appear professional right out of the box because of careful stylistic choices, like using Computer Modern Roman as the default font rather than Times New Roman, a surefire way to spot a document made with Microsoft Word.</p></li><li><p>Though costly PDF authoring software certainly exists, LaTeX submissions are accepted by many academic journals. The LaTeX software is free and open source, with a long history of producing high-quality documents for publishing.</p></li><li><p>PDFs are standalone, meaning you can download one file, save it locally, and open it later in any PDF reader you like. You don't have to browse back to the journal's archive to read the paper, which adds to the convenience of the PDF format.</p></li></ul><p>Considering each of these points in turn, however, may show you why PDF is not necessarily the perfect choice for academic publishing.</p><ul><li><p>PDF documents do look nice, but they are not the only vehicle for aesthetically-pleasing content. Vectorized fonts are readily available outside the PDF standard. Changing to another document format does not mean the documents have to be rasterized or lose their visual appeal.</p></li><li><p>Academics, myself included, can usually spot a document typeset with LaTeX from a mile away. We see them every day on preprint servers and journal archives, to the point that information conveyed in LaTeX source or PDF just seems more trustworthy now. Don't believe me? <a href="https://xkcd.com/1301">It's literally the subject of an xkcd comic.</a></p></li><li><p>LaTeX is a common tool for typesetting publication-quality documents that many researchers use frequently. It is not the only authoring tool freely available, though, just the current standard.</p></li><li><p>Though standalone digital files, PDFs are inherently linked to the idea of print media. When you download a journal article as a PDF, the document you receive is divided into pages already, complete with headers, footers, and page numbers, which are arguably unnecessary in an age when most academics read the paper in its digital form. When did you last print out an article on actual, physical paper?</p></li></ul></div></div></div><script defer="defer" src="/elucidate/assets/common-main~toolbox~mathml~colormap~tutorial.js"></script><script defer="defer" src="/elucidate/assets/main.bundle.js"></script></body></html>
Loading

0 comments on commit 3c8e2a0

Please sign in to comment.