Skip to content

Commit

Permalink
build based on 1007122
Browse files Browse the repository at this point in the history
  • Loading branch information
Documenter.jl committed Jul 31, 2024
1 parent bc6b2ec commit c251e2c
Show file tree
Hide file tree
Showing 155 changed files with 190 additions and 189 deletions.
2 changes: 1 addition & 1 deletion dev/.documenter-siteinfo.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"documenter":{"julia_version":"1.10.4","generation_timestamp":"2024-07-30T05:47:56","documenter_version":"1.5.0"}}
{"documenter":{"julia_version":"1.10.4","generation_timestamp":"2024-07-31T05:45:59","documenter_version":"1.5.0"}}

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dev/Articles/Maybe-I-f-ed-my-career/index.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dev/Computing/01-Scientific-Computing/index.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion dev/Computing/02-General-Computing-Skills/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
sudo mkdir /mnt/z

# Mount the network drive in WSL:
sudo mount -t drvfs Z: /mnt/z</code></pre><hr/><h2 id="Regular-expressions"><a class="docs-heading-anchor" href="#Regular-expressions">Regular expressions</a><a id="Regular-expressions-1"></a><a class="docs-heading-anchor-permalink" href="#Regular-expressions" title="Permalink"></a></h2><p>Regular expressions (or simply <em>regex</em>) processing is a must-have skill for anyone doing scientific computing. Most programs produce results or logs in plain text and do not support specific data extraction from those. There <em>regex</em> becomes your best friend. Unfortunately during the years many flavors of regex appeared, each claiming to offer advantages or to be more formal than its predecessors. Due to this, learning regex is often language-specific (most of the time you create and process regex from your favorite language) and sometimes even package-specific. Needless to say, regex may be more difficult to master than assembly programming.</p><ul><li><p>Useful web applications can be found in <a href="https://regex101.com/">regex101</a> and <a href="https://regexr.com/">regexr</a>.</p></li><li><p>Match <a href="https://stackoverflow.com/questions/6109882/regex-match-all-characters-between-two-strings">all characters between two strings</a> with lookbehind and look ahead patterns. Notice that this will require the enclosing strings to be fixed (at least under PCRE). For processing <code>WallyTutor.jl</code> documentation I have used a <a href="https://github.com/wallytutor/WallyToolbox.jl/blob/89603a88d54eed1d15b9f8142640ef942cfa12ca/docs/formatter.jl#L20">more generic approach</a> but less general than what is proposed <a href="https://stackoverflow.com/questions/14182879/regex-to-match-latex-equations">here</a>.</p></li><li><p>Match <a href="https://stackoverflow.com/questions/159118">any character across multiple lines</a> with <code>(.|\n)*</code>.</p></li><li><p>Currently joining regexes in Julia might be tricky (because of escaping characters); a solution is proposed <a href="https://stackoverflow.com/questions/20478823/joining-regular-expressions-in-julia">here</a> and seems to work just fine with minimal extra coding.</p></li></ul><hr/><h2 id="\\LaTeX"><a class="docs-heading-anchor" href="#\\LaTeX"><span>$\LaTeX$</span></a><a id="\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#\\LaTeX" title="Permalink"></a></h2><h3 id="Math-typesetting-with-\\LaTeX"><a class="docs-heading-anchor" href="#Math-typesetting-with-\\LaTeX">Math typesetting with <span>$\LaTeX$</span></a><a id="Math-typesetting-with-\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#Math-typesetting-with-\\LaTeX" title="Permalink"></a></h3><ul><li>For integrals to display the same size as fractions expanded with <code>\dfrac</code>, place a <code>\displaystyle</code> in front of the <code>\int</code> command.</li></ul><h3 id="Code-typesetting-with-\\LaTeX"><a class="docs-heading-anchor" href="#Code-typesetting-with-\\LaTeX">Code typesetting with <span>$\LaTeX$</span></a><a id="Code-typesetting-with-\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#Code-typesetting-with-\\LaTeX" title="Permalink"></a></h3><ul><li><p>For some reason <code>minted</code> blocks <code>\begin{minted}...\end{minted}</code> have problems to render in Beamer (something related to multilevel macros). I managed to insert code blocks with <code>\inputminted</code> as reported <a href="https://tex.stackexchange.com/questions/159667/including-python-code-in-beamer">here</a>.</p></li><li><p>Beamer have some issues with footnotes, especially when use <code>column</code> environments; a quick fix for this is through <code>\footnotemark</code> and <code>\footnotetext[&lt;number&gt;]{&lt;text&gt;}</code> as described <a href="https://tex.stackexchange.com/questions/86650/how-to-display-the-footnote-in-the-bottom-of-the-slide-while-using-columns">here</a>. Notice that <code>\footnotemark</code> automatically generates the counter for use as <code>&lt;number&gt;</code> in <code>\footnotetext</code>.</p></li><li><p>For setting a background watermark in Beamer one can use package <code>background</code> and display it using a Beamer template as described <a href="https://tex.stackexchange.com/questions/244091/watermark-using-background-package-in-beamer">here</a>.</p></li></ul><h3 id="MiKTeX"><a class="docs-heading-anchor" href="#MiKTeX">MiKTeX</a><a id="MiKTeX-1"></a><a class="docs-heading-anchor-permalink" href="#MiKTeX" title="Permalink"></a></h3><ul><li><p><a href="https://tex.stackexchange.com/questions/553716/mathkerncmssi-source-file-could-not-be-found">mathkerncmssi source file could not be found</a></p></li><li><p><a href="https://docs.miktex.org/manual/localadditions.html">Installing user packages and classes</a></p></li></ul><h3 id="LaTeX-Workshop"><a class="docs-heading-anchor" href="#LaTeX-Workshop">LaTeX Workshop</a><a id="LaTeX-Workshop-1"></a><a class="docs-heading-anchor-permalink" href="#LaTeX-Workshop" title="Permalink"></a></h3><ul><li><a href="https://tex.stackexchange.com/questions/478865/vs-code-latex-workshop-custom-recipes-file-location">Configuring builds in VS Code with LaTeX Workshop</a> for building with <code>pdflatex</code>. Finally I ended creating my own workflows in this <a href="https://github.com/wallytutor/WallyToolbox.jl/blob/main/tools/vscode/user-data/User/settings.json">file</a>.</li></ul></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../01-Scientific-Computing/">« Scientific Computing</a><a class="docs-footer-nextpage" href="../03-Programming-Languages/">Programming »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.5.0 on <span class="colophon-date" title="Tuesday 30 July 2024 05:47">Tuesday 30 July 2024</span>. Using Julia version 1.10.4.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
sudo mount -t drvfs Z: /mnt/z</code></pre><hr/><h2 id="Regular-expressions"><a class="docs-heading-anchor" href="#Regular-expressions">Regular expressions</a><a id="Regular-expressions-1"></a><a class="docs-heading-anchor-permalink" href="#Regular-expressions" title="Permalink"></a></h2><p>Regular expressions (or simply <em>regex</em>) processing is a must-have skill for anyone doing scientific computing. Most programs produce results or logs in plain text and do not support specific data extraction from those. There <em>regex</em> becomes your best friend. Unfortunately during the years many flavors of regex appeared, each claiming to offer advantages or to be more formal than its predecessors. Due to this, learning regex is often language-specific (most of the time you create and process regex from your favorite language) and sometimes even package-specific. Needless to say, regex may be more difficult to master than assembly programming.</p><ul><li><p>Useful web applications can be found in <a href="https://regex101.com/">regex101</a> and <a href="https://regexr.com/">regexr</a>.</p></li><li><p>Match <a href="https://stackoverflow.com/questions/6109882/regex-match-all-characters-between-two-strings">all characters between two strings</a> with lookbehind and look ahead patterns. Notice that this will require the enclosing strings to be fixed (at least under PCRE). For processing <code>WallyTutor.jl</code> documentation I have used a <a href="https://github.com/wallytutor/WallyToolbox.jl/blob/89603a88d54eed1d15b9f8142640ef942cfa12ca/docs/formatter.jl#L20">more generic approach</a> but less general than what is proposed <a href="https://stackoverflow.com/questions/14182879/regex-to-match-latex-equations">here</a>.</p></li><li><p>Match <a href="https://stackoverflow.com/questions/159118">any character across multiple lines</a> with <code>(.|\n)*</code>.</p></li><li><p>Currently joining regexes in Julia might be tricky (because of escaping characters); a solution is proposed <a href="https://stackoverflow.com/questions/20478823/joining-regular-expressions-in-julia">here</a> and seems to work just fine with minimal extra coding.</p></li></ul><hr/><h2 id="\\LaTeX"><a class="docs-heading-anchor" href="#\\LaTeX"><span>$\LaTeX$</span></a><a id="\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#\\LaTeX" title="Permalink"></a></h2><h3 id="Math-typesetting-with-\\LaTeX"><a class="docs-heading-anchor" href="#Math-typesetting-with-\\LaTeX">Math typesetting with <span>$\LaTeX$</span></a><a id="Math-typesetting-with-\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#Math-typesetting-with-\\LaTeX" title="Permalink"></a></h3><ul><li>For integrals to display the same size as fractions expanded with <code>\dfrac</code>, place a <code>\displaystyle</code> in front of the <code>\int</code> command.</li></ul><h3 id="Code-typesetting-with-\\LaTeX"><a class="docs-heading-anchor" href="#Code-typesetting-with-\\LaTeX">Code typesetting with <span>$\LaTeX$</span></a><a id="Code-typesetting-with-\\LaTeX-1"></a><a class="docs-heading-anchor-permalink" href="#Code-typesetting-with-\\LaTeX" title="Permalink"></a></h3><ul><li><p>For some reason <code>minted</code> blocks <code>\begin{minted}...\end{minted}</code> have problems to render in Beamer (something related to multilevel macros). I managed to insert code blocks with <code>\inputminted</code> as reported <a href="https://tex.stackexchange.com/questions/159667/including-python-code-in-beamer">here</a>.</p></li><li><p>Beamer have some issues with footnotes, especially when use <code>column</code> environments; a quick fix for this is through <code>\footnotemark</code> and <code>\footnotetext[&lt;number&gt;]{&lt;text&gt;}</code> as described <a href="https://tex.stackexchange.com/questions/86650/how-to-display-the-footnote-in-the-bottom-of-the-slide-while-using-columns">here</a>. Notice that <code>\footnotemark</code> automatically generates the counter for use as <code>&lt;number&gt;</code> in <code>\footnotetext</code>.</p></li><li><p>For setting a background watermark in Beamer one can use package <code>background</code> and display it using a Beamer template as described <a href="https://tex.stackexchange.com/questions/244091/watermark-using-background-package-in-beamer">here</a>.</p></li></ul><h3 id="MiKTeX"><a class="docs-heading-anchor" href="#MiKTeX">MiKTeX</a><a id="MiKTeX-1"></a><a class="docs-heading-anchor-permalink" href="#MiKTeX" title="Permalink"></a></h3><ul><li><p><a href="https://tex.stackexchange.com/questions/553716/mathkerncmssi-source-file-could-not-be-found">mathkerncmssi source file could not be found</a></p></li><li><p><a href="https://docs.miktex.org/manual/localadditions.html">Installing user packages and classes</a></p></li></ul><h3 id="LaTeX-Workshop"><a class="docs-heading-anchor" href="#LaTeX-Workshop">LaTeX Workshop</a><a id="LaTeX-Workshop-1"></a><a class="docs-heading-anchor-permalink" href="#LaTeX-Workshop" title="Permalink"></a></h3><ul><li><a href="https://tex.stackexchange.com/questions/478865/vs-code-latex-workshop-custom-recipes-file-location">Configuring builds in VS Code with LaTeX Workshop</a> for building with <code>pdflatex</code>. Finally I ended creating my own workflows in this <a href="https://github.com/wallytutor/WallyToolbox.jl/blob/main/tools/vscode/user-data/User/settings.json">file</a>.</li></ul></article><nav class="docs-footer"><a class="docs-footer-prevpage" href="../01-Scientific-Computing/">« Scientific Computing</a><a class="docs-footer-nextpage" href="../03-Programming-Languages/">Programming »</a><div class="flexbox-break"></div><p class="footer-message">Powered by <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> and the <a href="https://julialang.org/">Julia Programming Language</a>.</p></nav></div><div class="modal" id="documenter-settings"><div class="modal-background"></div><div class="modal-card"><header class="modal-card-head"><p class="modal-card-title">Settings</p><button class="delete"></button></header><section class="modal-card-body"><p><label class="label">Theme</label><div class="select"><select id="documenter-themepicker"><option value="auto">Automatic (OS)</option><option value="documenter-light">documenter-light</option><option value="documenter-dark">documenter-dark</option><option value="catppuccin-latte">catppuccin-latte</option><option value="catppuccin-frappe">catppuccin-frappe</option><option value="catppuccin-macchiato">catppuccin-macchiato</option><option value="catppuccin-mocha">catppuccin-mocha</option></select></div></p><hr/><p>This document was generated with <a href="https://github.com/JuliaDocs/Documenter.jl">Documenter.jl</a> version 1.5.0 on <span class="colophon-date" title="Wednesday 31 July 2024 05:45">Wednesday 31 July 2024</span>. Using Julia version 1.10.4.</p></section><footer class="modal-card-foot"></footer></div></div></div></body></html>
2 changes: 1 addition & 1 deletion dev/Computing/03-Programming-Languages/index.html

Large diffs are not rendered by default.

Loading

0 comments on commit c251e2c

Please sign in to comment.