Edit page History How do I edit this website?

Debugging

The best way to collect debugging information is to build the site locally. However if that isn’t an option, this page documents tags which can be helpful.

Echo

This echo include just prints its arguments, for debugging/learning purposes. This can be helpful in understanding Liquid syntax and how strings are being read internally by an include.

Arguments are printed as a comma-separated list of "argument"==>"value" pairs.

Note that liquid allows the passing of arbitrary arguments to include templates. All these arguments will be stored, but won’t have any effect unless the include’s source actually does something with those arguments.

{% include echo content="This is the content argument" bracket="what if I pass {}?" gorilla="Why do we have a gorilla argument?" %}

{"content"=>"This is the content argument", "bracket"=>"what if I pass {}?", "gorilla"=>"Why do we have a gorilla argument?"}

What’s in a page?

Ever wonder what all is part of the page data structure? Let’s find out!

(You can also do this with the site data structure, but be warned: the output will include every page body across the whole site!)

{% include echo p=page %}

{"p"=>{ "path": "_pages/editing/debugging.md", "relative_path": "_pages/editing/debugging.md", "excerpt": "

The best way to collect debugging information is to <a href=\"/editing/advanced\">build the site locally</a>. However if that isn’t an option, this page documents tags which can be helpful.

\n\n", "previous": { "path": "_pages/editing/code.md", "relative_path": "_pages/editing/code.md", "excerpt": "

This page describes nice ways of embedding source code in a page.

\n\n", "previous": { "path": "_pages/editing/citations.md", "relative_path": "_pages/editing/citations.md", "excerpt": "

This page demonstrates how to add a citation to your page.

\n\n", "previous": { "path": "_pages/editing/buttons.md", "relative_path": "_pages/editing/buttons.md", "id": "/editing/buttons", "collection": "pages", "url": "/editing/buttons", "draft": false, "categories": [ ], "title": "Buttons", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "buttons", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/citations", "collection": "pages", "next": { "path": "_pages/editing/code.md", "relative_path": "_pages/editing/code.md", "id": "/editing/code", "collection": "pages", "url": "/editing/code", "draft": false, "categories": [ ], "title": "Source Code", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "code", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": "<!DOCTYPE html>\n\n\t\n\t\tCitations\n\t\t\t\t<meta charset=\"utf-8\" />\n\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1, user-scalable=no\" />\n\t\t<link rel=\"shortcut icon\" href=\"/favicon.png\">\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/lightbox.min.css\" />\n\t\t<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/instantsearch.css@7/themes/algolia-min.css\"/>\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/main.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/layout.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/infoboxes.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/dock.css\"/>\n\t\t\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/page.css\" />\n\t\n\t<body class=\"is-preload\">\n\t\t\n\t\t<section id=\"top-bar\">\n <a href=\"/\"><img id=\"site-logo\" src=\"/media/logo/logo-web.png\"></a>\n <div id=\"search-panel\">\n <div id=\"search-box\"></div>\n </div>\n</section>\n\n\n\t\t\n\t\t<div class=\"page-info\">\n\n <a href=\"https://github.com/micro-manager/micro-manager.github.io/edit/main/_pages/editing/citations.md\">Edit page</a>\n <a href=\"https://github.com/micro-manager/micro-manager.github.io/commits/main/_pages/editing/citations.md\">History</a>\n <a href=\"/editing\">How do I edit this website?</a>\n\n</div>\n\n\n\t\t<section id=\"left-column\" class=\"sidebar dock\">\n\t\t\t\n\t\t\t<div class=\"menu dockable\">\n <div class=\"drag-handle\"></div>

μManager Documentation

\n
    \n
  • <a href=\"/news/index\">News</a>
  • \n\n\n
  • <a href=\"/Download_Micro-Manager_Latest_Release\">Downloads</a>
      \n
    • <a href=\"/Micro-Manager_Nightly_Builds\">Nightly Builds</a>
    • \n
    • <a href=\"/Micro-Manager_Version_Archive\">Old Releases</a>
    • \n
    • <a href=\"/Micro-Manager_Installation_Notes\">Installation Notes</a>
    • \n
    • <a href=\"/Micro-Manager_Source_Code\">Source Code</a>
    • \n
    \n
    \n
  • \n\n\n\n
  • <a href=\"/Micro-Manager_Project_Overview\">Learn</a>
      \n \n
    • <a href=\"/Micro-Manager_Project_Overview\">Overview</a>
        \n
      • <a href=\"/Why_Micro-Manager\">Why Micro-Manager?</a>
      • \n
      • <a href=\"/Who_should_use_Micro-Manager\">Who should use Micro-Manager</a>
      • \n
      \n
      \n
    • \n\n\n \n
    • <a href=\"/Version_2.0\">Version 2.0</a>
        \n
      • <a href=\"/Version_2.0_Users_Guide\">User Guide</a>
      • \n
      • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
      • \n
      • <a href=\"/Version_2.0_Plugins\">Plugins</a>
      • \n
      • <a href=\"/Version_2.0_FAQ\">FAQ</a>
      • \n
      • <a href=\"/Version_2.0_More_Help_Topics\">More Help Topics</a>
      • \n
      • <a href=\"/Version_2.0_API\">API</a>
      • \n
      • <a href=\"/Version_2.0_API_Transition_Guide\">API Transition Guide</a>
      • \n
      • <a href=\"/Version_2.0_API_How_do_I\">API, How do I?</a>
      • \n
      • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">Javadoc</a>
      • \n
      • <a href=\"/Version_2.0_API_Events\">API Events</a>
      • \n
      • <a href=\"/Version_2.0_Plugins\">Writing Plugins</a>
      • \n
      • <a href=\"/Version_2.0_Scripts\">Scripting</a>
      • \n
      \n
      \n
    • \n\n\n \n
    • <a href=\"/Overview_of_the_documentation\">Version 1.4</a>
        \n
      • <a href=\"/Micro-Manager_User's_Guide\">User Guide</a>
      • \n
      • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
      • \n
      • <a href=\"/Plugins\">Plugins</a>
      • \n
      • <a href=\"http://valelab4.ucsf.edu/publications/2010EdelsteinCurrProt.pdf\">Tutorial (PDF)</a>
      • \n
      • <a href=\"http://www.jbmethods.org/jbm/article/view/36/29\">Advanced Methods</a>
      • \n
      • <a href=\"/Micro-Manager_FAQ-new\">FAQ</a>
      • \n
      • <a href=\"/More_Help_Topics\">More Help Topics</a>
      • \n
      • <a href=\"/Screencasts\">Video Screencasts</a>
      • \n
      \n
      \n
    • \n\n
    \n
    \n
  • \n\n\n\n
  • <a href=\"/Micro-Manager_Programming_Guide\">Extend</a>
      \n
    • <a href=\"/Script_Panel_GUI\">Scripting (Beanshell)</a>
    • \n
    • <a href=\"/Example_Beanshell_scripts\">Example Beanshell scripts</a>
    • \n
    • <a href=\"/Writing_plugins_for_Micro-Manager\">Writing Plugins</a>
    • \n
    • <a href=\"/Using_the_Micro-Manager_python_library\">Python</a>
    • \n
    • <a href=\"/Matlab\">Matlab</a>
    • \n
    • <a href=\"/Micro-Manager_File_Formats\">File Formats</a>
    • \n
    • <a href=\"/Search_Paths\">Search Paths</a>
    • \n
    • <a href=\"/Building_Micro-Manager_Device_Adapters\">Writing Device Adapters</a>
    • \n
    • <a href=\"/Free_third-party_tools_for_testing_communications_with_hardware\">Testing communication with hardware</a>
    • \n
    • <a href=\"/Building_and_debugging_Micro-Manager_source_code\">Building and Debugging Micro-Manager</a>
    • \n
    • <a href=\"/Multi-Dimensional_Acquisition_Programming\">Multi-D Acq. Programming</a>
    • \n
    • <a href=\"/Policies_for_inclusion_of_source_code\">Policies for inclusion of source code</a>
    • \n
    • <a href=\"https://github.com/micro-manager\">Source code repository history and tickets</a>
    • \n
    • APIs
        \n
      • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">2.0 MMStudio API Reference (Java/Beanshell)</a>
      • \n
      • <a href=\"/apidoc/mmstudio/1.4/org/micromanager/api/ScriptInterface.html\">1.4 MMStudio API Reference (Java/Beanshell)</a>
      • \n
      • <a href=\"/apidoc/mmcorej/latest/mmcorej/CMMCore.html\">Core API Reference (Java/Beanshell)</a>
      • \n
      • <a href=\"/apidoc/MMCore/latest/class_c_m_m_core.html\">Core API Reference (C++)</a>
      • \n
      • <a href=\"/apidoc/MMDevice/latest/class_m_m_1_1_device.html\">Device API Reference (C++)</a>
      • \n
      \n
      \n
    • \n\n
    \n
    \n
  • \n\n\n\n
  • <a href=\"/Device_Support\">Devices</a>
      \n
    • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
    • \n
    \n
    \n
  • \n\n\n\n
  • <a href=\"/Micro-Manager_Community\">Support</a>
      \n
    • <a href=\"/Contact\">Contact</a>
    • \n
    • <a href=\"/System_Integrators\">System Integrators</a>
    • \n
    • <a href=\"/Programming_Services\">Programming Services</a>
    • \n
    • <a href=\"/editing/\">Editing the Wiki</a>
        \n
      • <a href=\"/editing/advanced\">Advanced editing</a>
      • \n
      • <a href=\"/editing/buttons\">Buttons</a>
      • \n
      • <a class=\"current-page\">Citations</a>
      • \n
      • <a href=\"/editing/code\">Source Code</a>
      • \n
      • <a href=\"/editing/headers\">Headers</a>
      • \n
      • <a href=\"/editing/icons\">Icons</a>
      • \n
      • <a href=\"/editing/images\">Images</a>
      • \n
      • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
      • \n
      • <a href=\"/editing/linking\">Linking</a>
      • \n
      • <a href=\"/editing/math\">Math Expressions</a>
      • \n
      • <a href=\"/editing/notices\">Notices</a>
      • \n
      • <a href=\"/editing/pitfalls\">Pitfalls</a>
      • \n
      • <a href=\"/editing/symbols\">Symbols</a>
      • \n
      • <a href=\"/editing/tables\">Tables</a>
      • \n
      • <a href=\"/editing/videos\">Videos</a>
      • \n
      • <a href=\"/editing/whitespace\">Whitespace</a>
      • \n
      \n
      \n
    • \n \n
    \n
    \n
  • \n\n\n\n
  • <a href=\"/Credits\">Credits</a>
      \n
    • <a href=\"/Papers_citing_Micro-Manager\">Papers citing MicroManager</a>
    • \n
    • <a href=\"/Citing_Micro-Manager\">How to cite MicroManager</a>
    • \n
    \n
    \n
  • \n\n\n
\n</div>\n\t\t</section>\n\n\t\t\n\t\t<div class=\"container\">\n\t\t\t<header class=\"major special\">\n\t\t\t\t

Citations

\n\t\t\t</header>\n\t\t</div>\n\n\t<section id=\"right-column\" class=\"sidebar dock\">\n\t\t\t\n\t\t\t<div id=\"toc\" class=\"toc menu dockable\">\n\t\t\t\t<div class=\"drag-handle\"></div>\n\t\t\t\t

Page contents

\n\t\t\t\t<ul data-toc=\"#content\" data-toc-headings=\"h1,h2,h3,h4,h5,h6\"></ul>\n\t\t\t</div>\n\t\t</section>\n\n\t\t\n\t\t<div id=\"nav-bar\"><ul class=\"shadowed-box\">
  • <a href=\"/editing/index\">Introduction</a>
  • <a href=\"/editing/advanced\">Advanced Editing</a>
  • <a href=\"/editing/buttons\">Buttons</a>
  • Citations
  • <a href=\"/editing/code\">Source Code</a>
  • <a href=\"/editing/debugging\">Debugging</a>
  • <a href=\"/editing/headers\">Headers</a>
  • <a href=\"/editing/icons\">Icons</a>
  • <a href=\"/editing/images\">Images</a>
  • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
  • <a href=\"/editing/linking\">Linking</a>
  • <a href=\"/editing/math\">Math Expressions</a>
  • <a href=\"/editing/menu-paths\">Menu Paths</a>
  • <a href=\"/editing/navigation\">Navigation</a>
  • <a href=\"/editing/notices\">Notices</a>
  • <a href=\"/editing/pitfalls\">Pitfalls</a>
  • <a href=\"/editing/symbols\">Symbols</a>
  • <a href=\"/editing/tables\">Tables</a>
  • <a href=\"/editing/videos\">Videos</a>
  • <a href=\"/editing/whitespace\">Whitespace</a>
  • </ul></div>\n\n\t\t\n\t\t<section id=\"page\" class=\"main style1\">\n\t\t\t<div class=\"container\">\n\t\t\t\t<div class=\"box alt\"></div>\n\t\t\t\t<div id=\"content\" class=\"page-content\">\n\t\t\t\t\t

    This page demonstrates how to add a citation to your page.

    \n\n

    <code class=\"language-plaintext highlighter-rouge\">include citation</code> allows you to create a single-use citation, or footnote.

    \n\n<h2 id=\"include-citations\">Include Citations</h2>\n\n<h3 id=\"usage\">Usage</h3>\n

    This include creates a citation given the following inputs:\nauthor (all authors of the publication, this input will be presented as entered):

    \ntitle title of the publication
    \nurl url link to location the publication is hosted
    \nyear year of publication
    \njournal name of the publishing journal
    \nvolume volume of the publishing journal
    \nnumber issuing number of the publishing journal
    \npages page numbers that the publication appears in publishing journal
    \ndoi digital object identifier
    \nfn foot note number

    \n\n<h3 id=\"example\">Example</h3>\n

    The following liquid code:

    \n<div class=\"language-plaintext highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\">\n{% include cite content='journal' author='Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas'\nyear='2012'\ntitle='TrakEM2 software for neural circuit reconstruction' journal='PLoS ONE'\nurl='http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011'\ndoi='10.1371/journal.pone.0038011' %}\n\n</pre></div></div>\n

    produces:

    \n\n

    Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas (2012), “<a href=\"http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011\">TrakEM2 software for neural circuit reconstruction</a>”, PLoS ONE , doi:<a href=\"https://dx.doi.org/10.1371/journal.pone.0038011\">10.1371/journal.pone.0038011</a>.

    \n\n<h2 id=\"creating-footnotes\">Creating footnotes</h2>\n\n<h3 id=\"in-your-document\">In your document</h3>\n

    Use the <a href=\"https://kramdown.gettalong.org/quickref.html#footnotes\">kramdown syntax</a> in your document to refer to footnotes by number.

    \n\n

    NB: regardless of where the liquid reference appears in your document, footnote text will always be at the bottom.

    \n\n<h3 id=\"in-your-citation\">In your citation</h3>\n\n

    Specify the footnote number in the <code class=\"language-plaintext highlighter-rouge\">include</code>.

    \n\n

    The following markdown and liquid code:

    \n\n<div class=\"language-plaintext highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\">This is a reference[^1].\n\n\n{% include cite content='journal' author='Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas'\nyear='2012'\nfn='1'\ntitle='TrakEM2 software for neural circuit reconstruction' journal='PLoS ONE'\nurl='http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011'\ndoi='10.1371/journal.pone.0038011' %}\n\n</pre></div></div>\n

    produces:

    \n\n

    This is a reference<sup id=\"fnref:1\" role=\"doc-noteref\"><a href=\"#fn:1\" class=\"footnote\" rel=\"footnote\">1</a></sup>.

    \n\n<div class=\"footnotes\" role=\"doc-endnotes\">\n
      \n <li id=\"fn:1\" role=\"doc-endnote\">\n

      Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas (2012), “<a href=\"http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011\">TrakEM2 software for neural circuit reconstruction</a>”, PLoS ONE , doi:<a href=\"https://dx.doi.org/10.1371/journal.pone.0038011\">10.1371/journal.pone.0038011</a>. <a href=\"#fnref:1\" class=\"reversefootnote\" role=\"doc-backlink\">↩</a>

      \n </li>\n
    \n</div>\n\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t</section>\n\n\t\t\n\t\t<section id=\"footer\">\n <ul class=\"icons\">\n
  • <a href=\"https://github.com/micro-manager\" class=\"icon brands alt fa-github\"><span class=\"label\">GitHub</span></a>
  • \n
  • <a href=\"#\" class=\"icon solid alt fa-envelope\"><span class=\"label\">Email</span></a>
  • \n </ul>\n <ul class=\"copyright\">\n
  • © µManager
  • Design: <a href=\"http://html5up.net\">HTML5 UP</a>
  • \n </ul>\n</section>\n\n\n\t\t\n\t\t\t\t<nav role=\"navigation\">\n <div id=\"ham-toggle\">\n <input type=\"checkbox\" />\n \n \n \n <ul id=\"ham-menu\">\n <div class=\"menu\">

    μManager Documentation

    \n
      \n
    • <a href=\"/news/index\">News</a>
    • \n\n\n
    • <a href=\"/Download_Micro-Manager_Latest_Release\">Downloads</a>
        \n
      • <a href=\"/Micro-Manager_Nightly_Builds\">Nightly Builds</a>
      • \n
      • <a href=\"/Micro-Manager_Version_Archive\">Old Releases</a>
      • \n
      • <a href=\"/Micro-Manager_Installation_Notes\">Installation Notes</a>
      • \n
      • <a href=\"/Micro-Manager_Source_Code\">Source Code</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Project_Overview\">Learn</a>
        \n \n
      • <a href=\"/Micro-Manager_Project_Overview\">Overview</a>
          \n
        • <a href=\"/Why_Micro-Manager\">Why Micro-Manager?</a>
        • \n
        • <a href=\"/Who_should_use_Micro-Manager\">Who should use Micro-Manager</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Version_2.0\">Version 2.0</a>
          \n
        • <a href=\"/Version_2.0_Users_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Plugins</a>
        • \n
        • <a href=\"/Version_2.0_FAQ\">FAQ</a>
        • \n
        • <a href=\"/Version_2.0_More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Version_2.0_API\">API</a>
        • \n
        • <a href=\"/Version_2.0_API_Transition_Guide\">API Transition Guide</a>
        • \n
        • <a href=\"/Version_2.0_API_How_do_I\">API, How do I?</a>
        • \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">Javadoc</a>
        • \n
        • <a href=\"/Version_2.0_API_Events\">API Events</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Writing Plugins</a>
        • \n
        • <a href=\"/Version_2.0_Scripts\">Scripting</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Overview_of_the_documentation\">Version 1.4</a>
          \n
        • <a href=\"/Micro-Manager_User's_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Plugins\">Plugins</a>
        • \n
        • <a href=\"http://valelab4.ucsf.edu/publications/2010EdelsteinCurrProt.pdf\">Tutorial (PDF)</a>
        • \n
        • <a href=\"http://www.jbmethods.org/jbm/article/view/36/29\">Advanced Methods</a>
        • \n
        • <a href=\"/Micro-Manager_FAQ-new\">FAQ</a>
        • \n
        • <a href=\"/More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Screencasts\">Video Screencasts</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Programming_Guide\">Extend</a>
        \n
      • <a href=\"/Script_Panel_GUI\">Scripting (Beanshell)</a>
      • \n
      • <a href=\"/Example_Beanshell_scripts\">Example Beanshell scripts</a>
      • \n
      • <a href=\"/Writing_plugins_for_Micro-Manager\">Writing Plugins</a>
      • \n
      • <a href=\"/Using_the_Micro-Manager_python_library\">Python</a>
      • \n
      • <a href=\"/Matlab\">Matlab</a>
      • \n
      • <a href=\"/Micro-Manager_File_Formats\">File Formats</a>
      • \n
      • <a href=\"/Search_Paths\">Search Paths</a>
      • \n
      • <a href=\"/Building_Micro-Manager_Device_Adapters\">Writing Device Adapters</a>
      • \n
      • <a href=\"/Free_third-party_tools_for_testing_communications_with_hardware\">Testing communication with hardware</a>
      • \n
      • <a href=\"/Building_and_debugging_Micro-Manager_source_code\">Building and Debugging Micro-Manager</a>
      • \n
      • <a href=\"/Multi-Dimensional_Acquisition_Programming\">Multi-D Acq. Programming</a>
      • \n
      • <a href=\"/Policies_for_inclusion_of_source_code\">Policies for inclusion of source code</a>
      • \n
      • <a href=\"https://github.com/micro-manager\">Source code repository history and tickets</a>
      • \n
      • APIs
          \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">2.0 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmstudio/1.4/org/micromanager/api/ScriptInterface.html\">1.4 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmcorej/latest/mmcorej/CMMCore.html\">Core API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/MMCore/latest/class_c_m_m_core.html\">Core API Reference (C++)</a>
        • \n
        • <a href=\"/apidoc/MMDevice/latest/class_m_m_1_1_device.html\">Device API Reference (C++)</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Device_Support\">Devices</a>
        \n
      • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Community\">Support</a>
        \n
      • <a href=\"/Contact\">Contact</a>
      • \n
      • <a href=\"/System_Integrators\">System Integrators</a>
      • \n
      • <a href=\"/Programming_Services\">Programming Services</a>
      • \n
      • <a href=\"/editing/\">Editing the Wiki</a>
          \n
        • <a href=\"/editing/advanced\">Advanced editing</a>
        • \n
        • <a href=\"/editing/buttons\">Buttons</a>
        • \n
        • <a class=\"current-page\">Citations</a>
        • \n
        • <a href=\"/editing/code\">Source Code</a>
        • \n
        • <a href=\"/editing/headers\">Headers</a>
        • \n
        • <a href=\"/editing/icons\">Icons</a>
        • \n
        • <a href=\"/editing/images\">Images</a>
        • \n
        • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
        • \n
        • <a href=\"/editing/linking\">Linking</a>
        • \n
        • <a href=\"/editing/math\">Math Expressions</a>
        • \n
        • <a href=\"/editing/notices\">Notices</a>
        • \n
        • <a href=\"/editing/pitfalls\">Pitfalls</a>
        • \n
        • <a href=\"/editing/symbols\">Symbols</a>
        • \n
        • <a href=\"/editing/tables\">Tables</a>
        • \n
        • <a href=\"/editing/videos\">Videos</a>
        • \n
        • <a href=\"/editing/whitespace\">Whitespace</a>
        • \n
        \n
        \n
      • \n \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Credits\">Credits</a>
        \n
      • <a href=\"/Papers_citing_Micro-Manager\">Papers citing MicroManager</a>
      • \n
      • <a href=\"/Citing_Micro-Manager\">How to cite MicroManager</a>
      • \n
      \n
      \n
    • \n\n\n
    \n</div>\n </ul>\n </div>\n </nav>\n\n\n\t\t<div id=\"dock-overlay-left\" class=\"dock-overlay\" data-dock-target=\"left-column\"></div>\n\t\t<div id=\"dock-overlay-right\" class=\"dock-overlay\" data-dock-target=\"right-column\"></div>\n\n\t\t\n\t\t<div id=\"search-results\">\n <div id=\"search-hits\"></div>\n <div id=\"pagination\"></div>\n</div>\n\n\t\t\n\t\t\n<script src=\"/assets/js/jquery.min.js\"></script>\n<script src=\"/assets/js/jquery.scrolly.min.js\"></script>\n<script src=\"/assets/js/browser.min.js\"></script>\n<script src=\"/assets/js/breakpoints.min.js\"></script>\n<script src=\"/assets/js/util.js\"></script>\n<script src=\"/assets/js/jquery.toc.js\"></script>\n<script src=\"/assets/js/ham_nav.js\"></script>\n<script src=\"/assets/js/lightbox.min.js\"></script>\n<script type=\"text/javascript\" async\n src=\"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=default\">\n</script>\n\n<script src=\"/assets/js/main.js\"></script>\n<script src=\"/assets/js/dock.js\"></script>\n\n<script type=\"text/javascript\" src=\"https://cdn.jsdelivr.net/algoliasearch/3.32.0/algoliasearchLite.min.js\"></script>\n<script type=\"text/javascript\" src=\"https://cdn.jsdelivr.net/npm/instantsearch.js@4.21.0\"></script>\n<script src=\"/assets/js/search.js\"></script>\n<script src=\"/assets/js/search-tweaks.js\"></script>\n\n\n\t</body>\n\n", "content": "

    This page demonstrates how to add a citation to your page.

    \n\n

    <code class=\"language-plaintext highlighter-rouge\">include citation</code> allows you to create a single-use citation, or footnote.

    \n\n<h2 id=\"include-citations\">Include Citations</h2>\n\n<h3 id=\"usage\">Usage</h3>\n

    This include creates a citation given the following inputs:\nauthor (all authors of the publication, this input will be presented as entered):

    \ntitle title of the publication
    \nurl url link to location the publication is hosted
    \nyear year of publication
    \njournal name of the publishing journal
    \nvolume volume of the publishing journal
    \nnumber issuing number of the publishing journal
    \npages page numbers that the publication appears in publishing journal
    \ndoi digital object identifier
    \nfn foot note number

    \n\n<h3 id=\"example\">Example</h3>\n

    The following liquid code:

    \n<div class=\"language-plaintext highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\">\n{% include cite content='journal' author='Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas'\nyear='2012'\ntitle='TrakEM2 software for neural circuit reconstruction' journal='PLoS ONE'\nurl='http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011'\ndoi='10.1371/journal.pone.0038011' %}\n\n</pre></div></div>\n

    produces:

    \n\n

    Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas (2012), “<a href=\"http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011\">TrakEM2 software for neural circuit reconstruction</a>”, PLoS ONE , doi:<a href=\"https://dx.doi.org/10.1371/journal.pone.0038011\">10.1371/journal.pone.0038011</a>.

    \n\n<h2 id=\"creating-footnotes\">Creating footnotes</h2>\n\n<h3 id=\"in-your-document\">In your document</h3>\n

    Use the <a href=\"https://kramdown.gettalong.org/quickref.html#footnotes\">kramdown syntax</a> in your document to refer to footnotes by number.

    \n\n

    NB: regardless of where the liquid reference appears in your document, footnote text will always be at the bottom.

    \n\n<h3 id=\"in-your-citation\">In your citation</h3>\n\n

    Specify the footnote number in the <code class=\"language-plaintext highlighter-rouge\">include</code>.

    \n\n

    The following markdown and liquid code:

    \n\n<div class=\"language-plaintext highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\">This is a reference[^1].\n\n\n{% include cite content='journal' author='Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas'\nyear='2012'\nfn='1'\ntitle='TrakEM2 software for neural circuit reconstruction' journal='PLoS ONE'\nurl='http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011'\ndoi='10.1371/journal.pone.0038011' %}\n\n</pre></div></div>\n

    produces:

    \n\n

    This is a reference<sup id=\"fnref:1\" role=\"doc-noteref\"><a href=\"#fn:1\" class=\"footnote\" rel=\"footnote\">1</a></sup>.

    \n\n<div class=\"footnotes\" role=\"doc-endnotes\">\n
      \n <li id=\"fn:1\" role=\"doc-endnote\">\n

      Albert Cardona, Stephan Saalfeld, Johannes Schindelin, Ignacio Arganda-Carreras, Stephan Preibisch, Mark Longair, Pavel Tomancak, Volker Hartenstein and Rodney J. Douglas (2012), “<a href=\"http://www.plosone.org/article/info%3Adoi%2F10.1371%2Fjournal.pone.0038011\">TrakEM2 software for neural circuit reconstruction</a>”, PLoS ONE , doi:<a href=\"https://dx.doi.org/10.1371/journal.pone.0038011\">10.1371/journal.pone.0038011</a>. <a href=\"#fnref:1\" class=\"reversefootnote\" role=\"doc-backlink\">↩</a>

      \n </li>\n
    \n</div>\n", "url": "/editing/citations", "draft": false, "categories": [ ], "title": "Citations", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "citations", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/code", "collection": "pages", "next": { "path": "_pages/editing/debugging.md", "relative_path": "_pages/editing/debugging.md", "excerpt": "

    The best way to collect debugging information is to <a href=\"/editing/advanced\">build the site locally</a>. However if that isn’t an option, this page documents tags which can be helpful.

    \n\n", "previous": { "path": "_pages/editing/code.md", "relative_path": "_pages/editing/code.md", "id": "/editing/code", "collection": "pages", "url": "/editing/code", "draft": false, "categories": [ ], "title": "Source Code", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "code", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/debugging", "collection": "pages", "next": { "path": "_pages/editing/headers.md", "relative_path": "_pages/editing/headers.md", "id": "/editing/headers", "collection": "pages", "url": "/editing/headers", "draft": false, "categories": [ ], "title": "Headers", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "headers", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": null, "content": "The best way to collect debugging information is to [build the site locally](/editing/advanced). However if that isn't an option, this page documents tags which can be helpful.\n\n## Echo\n\nThis `echo` include just prints its arguments, for debugging/learning purposes. This can be helpful in understanding Liquid syntax and how strings are being read internally by an `include`.\n\nArguments are printed as a comma-separated list of `\"argument\"==>\"value\"` pairs.\n\nNote that liquid allows the passing of [arbitrary arguments](https://jekyllrb.com/docs/includes/) to `include` templates. All these arguments will be stored, but won't have any effect unless the `include`'s [source](https://github.com/micro-manager/micro-manager.github.io/tree/main/_includes) actually does something with those arguments.\n\n{% highlight liquid %}{% raw %}{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}{% endraw %}{% endhighlight %}\n{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}\n\n### What's in a `page`?\n\n{% include notice icon=\"tech\" content=\"Ever wonder what all is part of the `page` data structure? Let's find out!\n\n(You can also do this with the `site` data structure, but be warned: the output will include every page body across the whole site!)\" %}\n\n{% highlight liquid %}{% raw %}{% include echo p=page %}{% endraw %}{% endhighlight %}\n{% include echo p=page %}\n", "url": "/editing/debugging", "draft": false, "categories": [ ], "title": "Debugging", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "debugging", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": "<!DOCTYPE html>\n\n\t\n\t\tSource Code\n\t\t\t\t<meta charset=\"utf-8\" />\n\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1, user-scalable=no\" />\n\t\t<link rel=\"shortcut icon\" href=\"/favicon.png\">\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/lightbox.min.css\" />\n\t\t<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/instantsearch.css@7/themes/algolia-min.css\"/>\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/main.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/layout.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/infoboxes.css\" />\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/dock.css\"/>\n\t\t\n\t\t<link rel=\"stylesheet\" href=\"/assets/css/page.css\" />\n\t\n\t<body class=\"is-preload\">\n\t\t\n\t\t<section id=\"top-bar\">\n <a href=\"/\"><img id=\"site-logo\" src=\"/media/logo/logo-web.png\"></a>\n <div id=\"search-panel\">\n <div id=\"search-box\"></div>\n </div>\n</section>\n\n\n\t\t\n\t\t<div class=\"page-info\">\n\n <a href=\"https://github.com/micro-manager/micro-manager.github.io/edit/main/_pages/editing/code.md\">Edit page</a>\n <a href=\"https://github.com/micro-manager/micro-manager.github.io/commits/main/_pages/editing/code.md\">History</a>\n <a href=\"/editing\">How do I edit this website?</a>\n\n</div>\n\n\n\t\t<section id=\"left-column\" class=\"sidebar dock\">\n\t\t\t\n\t\t\t<div class=\"menu dockable\">\n <div class=\"drag-handle\"></div>

    μManager Documentation

    \n
      \n
    • <a href=\"/news/index\">News</a>
    • \n\n\n
    • <a href=\"/Download_Micro-Manager_Latest_Release\">Downloads</a>
        \n
      • <a href=\"/Micro-Manager_Nightly_Builds\">Nightly Builds</a>
      • \n
      • <a href=\"/Micro-Manager_Version_Archive\">Old Releases</a>
      • \n
      • <a href=\"/Micro-Manager_Installation_Notes\">Installation Notes</a>
      • \n
      • <a href=\"/Micro-Manager_Source_Code\">Source Code</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Project_Overview\">Learn</a>
        \n \n
      • <a href=\"/Micro-Manager_Project_Overview\">Overview</a>
          \n
        • <a href=\"/Why_Micro-Manager\">Why Micro-Manager?</a>
        • \n
        • <a href=\"/Who_should_use_Micro-Manager\">Who should use Micro-Manager</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Version_2.0\">Version 2.0</a>
          \n
        • <a href=\"/Version_2.0_Users_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Plugins</a>
        • \n
        • <a href=\"/Version_2.0_FAQ\">FAQ</a>
        • \n
        • <a href=\"/Version_2.0_More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Version_2.0_API\">API</a>
        • \n
        • <a href=\"/Version_2.0_API_Transition_Guide\">API Transition Guide</a>
        • \n
        • <a href=\"/Version_2.0_API_How_do_I\">API, How do I?</a>
        • \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">Javadoc</a>
        • \n
        • <a href=\"/Version_2.0_API_Events\">API Events</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Writing Plugins</a>
        • \n
        • <a href=\"/Version_2.0_Scripts\">Scripting</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Overview_of_the_documentation\">Version 1.4</a>
          \n
        • <a href=\"/Micro-Manager_User's_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Plugins\">Plugins</a>
        • \n
        • <a href=\"http://valelab4.ucsf.edu/publications/2010EdelsteinCurrProt.pdf\">Tutorial (PDF)</a>
        • \n
        • <a href=\"http://www.jbmethods.org/jbm/article/view/36/29\">Advanced Methods</a>
        • \n
        • <a href=\"/Micro-Manager_FAQ-new\">FAQ</a>
        • \n
        • <a href=\"/More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Screencasts\">Video Screencasts</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Programming_Guide\">Extend</a>
        \n
      • <a href=\"/Script_Panel_GUI\">Scripting (Beanshell)</a>
      • \n
      • <a href=\"/Example_Beanshell_scripts\">Example Beanshell scripts</a>
      • \n
      • <a href=\"/Writing_plugins_for_Micro-Manager\">Writing Plugins</a>
      • \n
      • <a href=\"/Using_the_Micro-Manager_python_library\">Python</a>
      • \n
      • <a href=\"/Matlab\">Matlab</a>
      • \n
      • <a href=\"/Micro-Manager_File_Formats\">File Formats</a>
      • \n
      • <a href=\"/Search_Paths\">Search Paths</a>
      • \n
      • <a href=\"/Building_Micro-Manager_Device_Adapters\">Writing Device Adapters</a>
      • \n
      • <a href=\"/Free_third-party_tools_for_testing_communications_with_hardware\">Testing communication with hardware</a>
      • \n
      • <a href=\"/Building_and_debugging_Micro-Manager_source_code\">Building and Debugging Micro-Manager</a>
      • \n
      • <a href=\"/Multi-Dimensional_Acquisition_Programming\">Multi-D Acq. Programming</a>
      • \n
      • <a href=\"/Policies_for_inclusion_of_source_code\">Policies for inclusion of source code</a>
      • \n
      • <a href=\"https://github.com/micro-manager\">Source code repository history and tickets</a>
      • \n
      • APIs
          \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">2.0 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmstudio/1.4/org/micromanager/api/ScriptInterface.html\">1.4 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmcorej/latest/mmcorej/CMMCore.html\">Core API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/MMCore/latest/class_c_m_m_core.html\">Core API Reference (C++)</a>
        • \n
        • <a href=\"/apidoc/MMDevice/latest/class_m_m_1_1_device.html\">Device API Reference (C++)</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Device_Support\">Devices</a>
        \n
      • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Community\">Support</a>
        \n
      • <a href=\"/Contact\">Contact</a>
      • \n
      • <a href=\"/System_Integrators\">System Integrators</a>
      • \n
      • <a href=\"/Programming_Services\">Programming Services</a>
      • \n
      • <a href=\"/editing/\">Editing the Wiki</a>
          \n
        • <a href=\"/editing/advanced\">Advanced editing</a>
        • \n
        • <a href=\"/editing/buttons\">Buttons</a>
        • \n
        • <a href=\"/editing/citations\">Citations</a>
        • \n
        • <a class=\"current-page\">Source Code</a>
        • \n
        • <a href=\"/editing/headers\">Headers</a>
        • \n
        • <a href=\"/editing/icons\">Icons</a>
        • \n
        • <a href=\"/editing/images\">Images</a>
        • \n
        • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
        • \n
        • <a href=\"/editing/linking\">Linking</a>
        • \n
        • <a href=\"/editing/math\">Math Expressions</a>
        • \n
        • <a href=\"/editing/notices\">Notices</a>
        • \n
        • <a href=\"/editing/pitfalls\">Pitfalls</a>
        • \n
        • <a href=\"/editing/symbols\">Symbols</a>
        • \n
        • <a href=\"/editing/tables\">Tables</a>
        • \n
        • <a href=\"/editing/videos\">Videos</a>
        • \n
        • <a href=\"/editing/whitespace\">Whitespace</a>
        • \n
        \n
        \n
      • \n \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Credits\">Credits</a>
        \n
      • <a href=\"/Papers_citing_Micro-Manager\">Papers citing MicroManager</a>
      • \n
      • <a href=\"/Citing_Micro-Manager\">How to cite MicroManager</a>
      • \n
      \n
      \n
    • \n\n\n
    \n</div>\n\t\t</section>\n\n\t\t\n\t\t<div class=\"container\">\n\t\t\t<header class=\"major special\">\n\t\t\t\t

    Source Code

    \n\t\t\t</header>\n\t\t</div>\n\n\t<section id=\"right-column\" class=\"sidebar dock\">\n\t\t\t\n\t\t\t<div id=\"toc\" class=\"toc menu dockable\">\n\t\t\t\t<div class=\"drag-handle\"></div>\n\t\t\t\t

    Page contents

    \n\t\t\t\t<ul data-toc=\"#content\" data-toc-headings=\"h1,h2,h3,h4,h5,h6\"></ul>\n\t\t\t</div>\n\t\t</section>\n\n\t\t\n\t\t<div id=\"nav-bar\"><ul class=\"shadowed-box\">
  • <a href=\"/editing/index\">Introduction</a>
  • <a href=\"/editing/advanced\">Advanced Editing</a>
  • <a href=\"/editing/buttons\">Buttons</a>
  • <a href=\"/editing/citations\">Citations</a>
  • Source Code
  • <a href=\"/editing/debugging\">Debugging</a>
  • <a href=\"/editing/headers\">Headers</a>
  • <a href=\"/editing/icons\">Icons</a>
  • <a href=\"/editing/images\">Images</a>
  • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
  • <a href=\"/editing/linking\">Linking</a>
  • <a href=\"/editing/math\">Math Expressions</a>
  • <a href=\"/editing/menu-paths\">Menu Paths</a>
  • <a href=\"/editing/navigation\">Navigation</a>
  • <a href=\"/editing/notices\">Notices</a>
  • <a href=\"/editing/pitfalls\">Pitfalls</a>
  • <a href=\"/editing/symbols\">Symbols</a>
  • <a href=\"/editing/tables\">Tables</a>
  • <a href=\"/editing/videos\">Videos</a>
  • <a href=\"/editing/whitespace\">Whitespace</a>
  • </ul></div>\n\n\t\t\n\t\t<section id=\"page\" class=\"main style1\">\n\t\t\t<div class=\"container\">\n\t\t\t\t<div class=\"box alt\"></div>\n\t\t\t\t<div id=\"content\" class=\"page-content\">\n\t\t\t\t\t

    This page describes nice ways of embedding source code in a page.

    \n\n<h2 id=\"inline-code-snippets\">Inline code snippets</h2>\n\n

    If you just want to write a short snippet of code as part of a sentence,\nsurround the code in backtick symbols (`).

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">Type `print('Hello world!')` and save as `hello.py`.</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n

    Type <code class=\"language-plaintext highlighter-rouge\">print('Hello world!')</code> and save as <code class=\"language-plaintext highlighter-rouge\">hello.py</code>.

    \n\n
    \n</div>\n</div>\n\n<h2 id=\"code-fences\">Code fences</h2>\n\n

    A “code fence” is three backtick symbols (```) preceding your\ncode, and another three concluding it. Optionally, you can write the name of\nthe language in small case next to the leading fence to declare syntax\nhighlighting is desired with the stated language.

    \n\n<h3 id=\"java-example\">Java example</h3>\n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">```java\nImage3DUniverse univ = new Image3DUniverse();\nuniv.show();\nuniv.addMesh(yourImagePlus, null, \"somename\", 50,\n  new boolean[] {true, true, true}, 2);\n```</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <div class=\"language-java highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\"><span class=\"nc\">Image3DUniverse</span> <span class=\"n\">univ</span> <span class=\"o\">=</span> <span class=\"k\">new</span> <span class=\"nc\">Image3DUniverse</span><span class=\"o\">();</span>\n<span class=\"n\">univ</span><span class=\"o\">.</span><span class=\"na\">show</span><span class=\"o\">();</span>\n<span class=\"n\">univ</span><span class=\"o\">.</span><span class=\"na\">addMesh</span><span class=\"o\">(</span><span class=\"n\">yourImagePlus</span><span class=\"o\">,</span> <span class=\"kc\">null</span><span class=\"o\">,</span> <span class=\"s\">\"somename\"</span><span class=\"o\">,</span> <span class=\"mi\">50</span><span class=\"o\">,</span>\n <span class=\"k\">new</span> <span class=\"kt\">boolean</span><span class=\"o\">[]</span> <span class=\"o\">{</span><span class=\"kc\">true</span><span class=\"o\">,</span> <span class=\"kc\">true</span><span class=\"o\">,</span> <span class=\"kc\">true</span><span class=\"o\">},</span> <span class=\"mi\">2</span><span class=\"o\">);</span>\n</pre>
    </div>\n\n </div>\n</div>\n</div>\n\n<h3 id=\"python-example\">Python example</h3>\n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">```python\ndef update_progress(progress):\n    barLength = 10 # length of progress bar\n    block = int(round(barLength*progress))\n    text = f'\\rPercent complete: ' +\n      f'[{\"#\"*block + \"-\"*(barLength-block)}] ' +\n      f'{progress*100}%'\n    sys.stdout.write(text)\n    sys.stdout.flush()\n```</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <div class=\"language-python highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\"><span class=\"k\">def</span> <span class=\"nf\">update_progress</span><span class=\"p\">(</span><span class=\"n\">progress</span><span class=\"p\">):</span>\n <span class=\"n\">barLength</span> <span class=\"o\">=</span> <span class=\"mi\">10</span> <span class=\"c1\"># length of progress bar\n</span> <span class=\"n\">block</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">round</span><span class=\"p\">(</span><span class=\"n\">barLength</span><span class=\"o\">*</span><span class=\"n\">progress</span><span class=\"p\">))</span>\n <span class=\"n\">text</span> <span class=\"o\">=</span> <span class=\"sa\">f</span><span class=\"s\">'</span><span class=\"se\">\\r</span><span class=\"s\">Percent complete: '</span> <span class=\"o\">+</span>\n <span class=\"sa\">f</span><span class=\"s\">'[</span><span class=\"si\">{</span><span class=\"s\">\"#\"</span><span class=\"o\">*</span><span class=\"n\">block</span> <span class=\"o\">+</span> <span class=\"s\">\"-\"</span><span class=\"o\">*</span><span class=\"p\">(</span><span class=\"n\">barLength</span><span class=\"o\">-</span><span class=\"n\">block</span><span class=\"p\">)</span><span class=\"si\">}</span><span class=\"s\">] '</span> <span class=\"o\">+</span>\n <span class=\"sa\">f</span><span class=\"s\">'</span><span class=\"si\">{</span><span class=\"n\">progress</span><span class=\"o\">*</span><span class=\"mi\">100</span><span class=\"si\">}</span><span class=\"s\">%'</span>\n <span class=\"n\">sys</span><span class=\"p\">.</span><span class=\"n\">stdout</span><span class=\"p\">.</span><span class=\"n\">write</span><span class=\"p\">(</span><span class=\"n\">text</span><span class=\"p\">)</span>\n <span class=\"n\">sys</span><span class=\"p\">.</span><span class=\"n\">stdout</span><span class=\"p\">.</span><span class=\"n\">flush</span><span class=\"p\">()</span>\n</pre>
    </div>\n\n </div>\n</div>\n</div>\n\n<h2 id=\"highlight-directive\">Highlight directive</h2>\n\n

    Alternately, there is a <code class=\"language-plaintext highlighter-rouge\">highlight</code> Liquid directive you can try.\nIt looks like this:

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\"><span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">highlight</span><span class=\"w\"> </span>java<span class=\"w\"> </span><span class=\"p\">%}</span>\nlog.info(\"You're a wizard, Harry!\");\nlog.error(\"I'm a what?\");\n<span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">endhighlight</span><span class=\"w\"> </span><span class=\"p\">%}</span></code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <figure class=\"highlight\">
    <code class=\"language-java\" data-lang=\"java\"><span class=\"n\">log</span><span class=\"o\">.</span><span class=\"na\">info</span><span class=\"o\">(</span><span class=\"s\">\"You're a wizard, Harry!\"</span><span class=\"o\">);</span>\n<span class=\"n\">log</span><span class=\"o\">.</span><span class=\"na\">error</span><span class=\"o\">(</span><span class=\"s\">\"I'm a what?\"</span><span class=\"o\">);</span></code>
    </figure>\n\n
    \n</div>\n</div>\n\n

    The <code class=\"language-plaintext highlighter-rouge\">highlight</code> directive and code fences are separate features, but\nfunctionally very similar. If code fences are not working as you like,\ngive the <code class=\"language-plaintext highlighter-rouge\">highlight</code> directive a try to see if it does any better.

    \n\n<h2 id=\"embedding-code-from-github\">Embedding code from GitHub</h2>\n\n

    If you have a block of code in a GitHub repository, you can embed it\ndynamically into the page using the <code class=\"language-plaintext highlighter-rouge\">github-embed</code> include. This approach has\nthe advantage of avoiding copy-paste skew as the code evolves over time.

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\"><span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">include</span><span class=\"w\"> </span><span class=\"nv\">github-embed</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">org</span><span class=\"o\">=</span><span class=\"s2\">\"duckythescientist\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">repo</span><span class=\"o\">=</span><span class=\"s2\">\"obfuscatedLife\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">branch</span><span class=\"o\">=</span><span class=\"s2\">\"original\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">path</span><span class=\"o\">=</span><span class=\"s2\">\"life.c\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">label</span><span class=\"o\">=</span><span class=\"s2\">\"Conway's Obfuscated Game of Life\"</span><span class=\"w\"> </span><span class=\"p\">%}</span></code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n

    <a href=\"https://github.com/duckythescientist/obfuscatedLife/blob/original/life.c\">Conway’s Obfuscated Game of Life</a>
    <script src=\"https://emgithub.com/embed.js?target=https%3A%2F%2Fgithub.com%2Fduckythescientist%2FobfuscatedLife%2Fblob%2Foriginal%2Flife.c%23L1-99999&style=github&showBorder=on&showLineNumbers=on&showFileMeta=on&showCopy=on\"></script>

    \n\n
    \n</div>\n</div>\n\n

    Other parameters supported by the <code class=\"language-plaintext highlighter-rouge\">github-embed</code> include are:

    \n\n\n \n \n <th style=\"text-align: left\">Parameter</th>\n <th style=\"text-align: left\">Description</th>\n <th style=\"text-align: left\">Values</th>\n \n \n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">line-start</code></td>\n <td style=\"text-align: left\">First line to embed</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">>= 1</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">line-end</code></td>\n <td style=\"text-align: left\">Last line to embed</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">>= 1</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">label</code></td>\n <td style=\"text-align: left\">Hyperlinked label to place before the code</td>\n <td style=\"text-align: left\">any string</td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">style</code></td>\n <td style=\"text-align: left\">Syntax highlighting color scheme</td>\n <td style=\"text-align: left\">various*</td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-border</code></td>\n <td style=\"text-align: left\">Whether to draw a border around the frame</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-line-numbers</code></td>\n <td style=\"text-align: left\">Whether to number the lines</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-file-meta</code></td>\n <td style=\"text-align: left\">Whether to include the footer with links</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-copy</code></td>\n <td style=\"text-align: left\">Whether to include the Copy button on mouseover</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n
    Default
    <code class=\"language-plaintext highlighter-rouge\">1</code>
    <code class=\"language-plaintext highlighter-rouge\">99999</code>
    no label
    <code class=\"language-plaintext highlighter-rouge\">github</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    \n\n

    * Valid style values are:

    \n<ul style=\"display: flex; flex-wrap: wrap; list-style: none;\">\n
  • a11y-dark
  • \n
  • a11y-light
  • \n
  • agate
  • \n
  • an-old-hope
  • \n
  • androidstudio
  • \n
  • arduino-light
  • \n
  • arta
  • \n
  • ascetic
  • \n
  • atelier-cave-dark
  • \n
  • atelier-cave-light
  • \n
  • atelier-dune-dark
  • \n
  • atelier-dune-light
  • \n
  • atelier-estuary-dark
  • \n
  • atelier-estuary-light
  • \n
  • atelier-forest-dark
  • \n
  • atelier-forest-light
  • \n
  • atelier-heath-dark
  • \n
  • atelier-heath-light
  • \n
  • atelier-lakeside-dark
  • \n
  • atelier-lakeside-light
  • \n
  • atelier-plateau-dark
  • \n
  • atelier-plateau-light
  • \n
  • atelier-savanna-dark
  • \n
  • atelier-savanna-light
  • \n
  • atelier-seaside-dark
  • \n
  • atelier-seaside-light
  • \n
  • atelier-sulphurpool-dark
  • \n
  • atelier-sulphurpool-light
  • \n
  • atom-one-dark
  • \n
  • atom-one-dark-reasonable
  • \n
  • atom-one-light
  • \n
  • codepen-embed
  • \n
  • color-brewer
  • \n
  • darcula
  • \n
  • dark
  • \n
  • default
  • \n
  • docco
  • \n
  • dracula
  • \n
  • far
  • \n
  • foundation
  • \n
  • github
  • \n
  • github-gist
  • \n
  • gml
  • \n
  • googlecode
  • \n
  • gradient-dark
  • \n
  • grayscale
  • \n
  • gruvbox-dark
  • \n
  • gruvbox-light
  • \n
  • hopscotch
  • \n
  • hybrid
  • \n
  • idea
  • \n
  • ir-black
  • \n
  • isbl-editor-dark
  • \n
  • isbl-editor-light
  • \n
  • kimbie.dark
  • \n
  • kimbie.light
  • \n
  • lightfair
  • \n
  • magula
  • \n
  • mono-blue
  • \n
  • monokai
  • \n
  • monokai-sublime
  • \n
  • night-owl
  • \n
  • nord
  • \n
  • obsidian
  • \n
  • ocean
  • \n
  • paraiso-dark
  • \n
  • paraiso-light
  • \n
  • purebasic
  • \n
  • qtcreator_dark
  • \n
  • qtcreator_light
  • \n
  • railscasts
  • \n
  • rainbow
  • \n
  • routeros
  • \n
  • shades-of-purple
  • \n
  • solarized-dark
  • \n
  • solarized-light
  • \n
  • sunburst
  • \n
  • tomorrow
  • \n
  • tomorrow-night
  • \n
  • tomorrow-night-blue
  • \n
  • tomorrow-night-bright
  • \n
  • tomorrow-night-eighties
  • \n
  • vs
  • \n
  • vs2015
  • \n
  • xcode
  • \n
  • xt256
  • \n
  • zenburn
  • \n</ul>\n\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t</section>\n\n\t\t\n\t\t<section id=\"footer\">\n <ul class=\"icons\">\n
  • <a href=\"https://github.com/micro-manager\" class=\"icon brands alt fa-github\"><span class=\"label\">GitHub</span></a>
  • \n
  • <a href=\"#\" class=\"icon solid alt fa-envelope\"><span class=\"label\">Email</span></a>
  • \n </ul>\n <ul class=\"copyright\">\n
  • © µManager
  • Design: <a href=\"http://html5up.net\">HTML5 UP</a>
  • \n </ul>\n</section>\n\n\n\t\t\n\t\t\t\t<nav role=\"navigation\">\n <div id=\"ham-toggle\">\n <input type=\"checkbox\" />\n \n \n \n <ul id=\"ham-menu\">\n <div class=\"menu\">

    μManager Documentation

    \n
      \n
    • <a href=\"/news/index\">News</a>
    • \n\n\n
    • <a href=\"/Download_Micro-Manager_Latest_Release\">Downloads</a>
        \n
      • <a href=\"/Micro-Manager_Nightly_Builds\">Nightly Builds</a>
      • \n
      • <a href=\"/Micro-Manager_Version_Archive\">Old Releases</a>
      • \n
      • <a href=\"/Micro-Manager_Installation_Notes\">Installation Notes</a>
      • \n
      • <a href=\"/Micro-Manager_Source_Code\">Source Code</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Project_Overview\">Learn</a>
        \n \n
      • <a href=\"/Micro-Manager_Project_Overview\">Overview</a>
          \n
        • <a href=\"/Why_Micro-Manager\">Why Micro-Manager?</a>
        • \n
        • <a href=\"/Who_should_use_Micro-Manager\">Who should use Micro-Manager</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Version_2.0\">Version 2.0</a>
          \n
        • <a href=\"/Version_2.0_Users_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Plugins</a>
        • \n
        • <a href=\"/Version_2.0_FAQ\">FAQ</a>
        • \n
        • <a href=\"/Version_2.0_More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Version_2.0_API\">API</a>
        • \n
        • <a href=\"/Version_2.0_API_Transition_Guide\">API Transition Guide</a>
        • \n
        • <a href=\"/Version_2.0_API_How_do_I\">API, How do I?</a>
        • \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">Javadoc</a>
        • \n
        • <a href=\"/Version_2.0_API_Events\">API Events</a>
        • \n
        • <a href=\"/Version_2.0_Plugins\">Writing Plugins</a>
        • \n
        • <a href=\"/Version_2.0_Scripts\">Scripting</a>
        • \n
        \n
        \n
      • \n\n\n \n
      • <a href=\"/Overview_of_the_documentation\">Version 1.4</a>
          \n
        • <a href=\"/Micro-Manager_User's_Guide\">User Guide</a>
        • \n
        • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
        • \n
        • <a href=\"/Plugins\">Plugins</a>
        • \n
        • <a href=\"http://valelab4.ucsf.edu/publications/2010EdelsteinCurrProt.pdf\">Tutorial (PDF)</a>
        • \n
        • <a href=\"http://www.jbmethods.org/jbm/article/view/36/29\">Advanced Methods</a>
        • \n
        • <a href=\"/Micro-Manager_FAQ-new\">FAQ</a>
        • \n
        • <a href=\"/More_Help_Topics\">More Help Topics</a>
        • \n
        • <a href=\"/Screencasts\">Video Screencasts</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Programming_Guide\">Extend</a>
        \n
      • <a href=\"/Script_Panel_GUI\">Scripting (Beanshell)</a>
      • \n
      • <a href=\"/Example_Beanshell_scripts\">Example Beanshell scripts</a>
      • \n
      • <a href=\"/Writing_plugins_for_Micro-Manager\">Writing Plugins</a>
      • \n
      • <a href=\"/Using_the_Micro-Manager_python_library\">Python</a>
      • \n
      • <a href=\"/Matlab\">Matlab</a>
      • \n
      • <a href=\"/Micro-Manager_File_Formats\">File Formats</a>
      • \n
      • <a href=\"/Search_Paths\">Search Paths</a>
      • \n
      • <a href=\"/Building_Micro-Manager_Device_Adapters\">Writing Device Adapters</a>
      • \n
      • <a href=\"/Free_third-party_tools_for_testing_communications_with_hardware\">Testing communication with hardware</a>
      • \n
      • <a href=\"/Building_and_debugging_Micro-Manager_source_code\">Building and Debugging Micro-Manager</a>
      • \n
      • <a href=\"/Multi-Dimensional_Acquisition_Programming\">Multi-D Acq. Programming</a>
      • \n
      • <a href=\"/Policies_for_inclusion_of_source_code\">Policies for inclusion of source code</a>
      • \n
      • <a href=\"https://github.com/micro-manager\">Source code repository history and tickets</a>
      • \n
      • APIs
          \n
        • <a href=\"/apidoc/mmstudio/latest/org/micromanager/Studio.html\">2.0 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmstudio/1.4/org/micromanager/api/ScriptInterface.html\">1.4 MMStudio API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/mmcorej/latest/mmcorej/CMMCore.html\">Core API Reference (Java/Beanshell)</a>
        • \n
        • <a href=\"/apidoc/MMCore/latest/class_c_m_m_core.html\">Core API Reference (C++)</a>
        • \n
        • <a href=\"/apidoc/MMDevice/latest/class_m_m_1_1_device.html\">Device API Reference (C++)</a>
        • \n
        \n
        \n
      • \n\n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Device_Support\">Devices</a>
        \n
      • <a href=\"/Micro-Manager_Configuration_Guide\">Hardware Configuration Guide</a>
      • \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Micro-Manager_Community\">Support</a>
        \n
      • <a href=\"/Contact\">Contact</a>
      • \n
      • <a href=\"/System_Integrators\">System Integrators</a>
      • \n
      • <a href=\"/Programming_Services\">Programming Services</a>
      • \n
      • <a href=\"/editing/\">Editing the Wiki</a>
          \n
        • <a href=\"/editing/advanced\">Advanced editing</a>
        • \n
        • <a href=\"/editing/buttons\">Buttons</a>
        • \n
        • <a href=\"/editing/citations\">Citations</a>
        • \n
        • <a class=\"current-page\">Source Code</a>
        • \n
        • <a href=\"/editing/headers\">Headers</a>
        • \n
        • <a href=\"/editing/icons\">Icons</a>
        • \n
        • <a href=\"/editing/images\">Images</a>
        • \n
        • <a href=\"/editing/keys\">Keyboard Shortcuts</a>
        • \n
        • <a href=\"/editing/linking\">Linking</a>
        • \n
        • <a href=\"/editing/math\">Math Expressions</a>
        • \n
        • <a href=\"/editing/notices\">Notices</a>
        • \n
        • <a href=\"/editing/pitfalls\">Pitfalls</a>
        • \n
        • <a href=\"/editing/symbols\">Symbols</a>
        • \n
        • <a href=\"/editing/tables\">Tables</a>
        • \n
        • <a href=\"/editing/videos\">Videos</a>
        • \n
        • <a href=\"/editing/whitespace\">Whitespace</a>
        • \n
        \n
        \n
      • \n \n
      \n
      \n
    • \n\n\n\n
    • <a href=\"/Credits\">Credits</a>
        \n
      • <a href=\"/Papers_citing_Micro-Manager\">Papers citing MicroManager</a>
      • \n
      • <a href=\"/Citing_Micro-Manager\">How to cite MicroManager</a>
      • \n
      \n
      \n
    • \n\n\n
    \n</div>\n </ul>\n </div>\n </nav>\n\n\n\t\t<div id=\"dock-overlay-left\" class=\"dock-overlay\" data-dock-target=\"left-column\"></div>\n\t\t<div id=\"dock-overlay-right\" class=\"dock-overlay\" data-dock-target=\"right-column\"></div>\n\n\t\t\n\t\t<div id=\"search-results\">\n <div id=\"search-hits\"></div>\n <div id=\"pagination\"></div>\n</div>\n\n\t\t\n\t\t\n<script src=\"/assets/js/jquery.min.js\"></script>\n<script src=\"/assets/js/jquery.scrolly.min.js\"></script>\n<script src=\"/assets/js/browser.min.js\"></script>\n<script src=\"/assets/js/breakpoints.min.js\"></script>\n<script src=\"/assets/js/util.js\"></script>\n<script src=\"/assets/js/jquery.toc.js\"></script>\n<script src=\"/assets/js/ham_nav.js\"></script>\n<script src=\"/assets/js/lightbox.min.js\"></script>\n<script type=\"text/javascript\" async\n src=\"https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=default\">\n</script>\n\n<script src=\"/assets/js/main.js\"></script>\n<script src=\"/assets/js/dock.js\"></script>\n\n<script type=\"text/javascript\" src=\"https://cdn.jsdelivr.net/algoliasearch/3.32.0/algoliasearchLite.min.js\"></script>\n<script type=\"text/javascript\" src=\"https://cdn.jsdelivr.net/npm/instantsearch.js@4.21.0\"></script>\n<script src=\"/assets/js/search.js\"></script>\n<script src=\"/assets/js/search-tweaks.js\"></script>\n\n\n\t</body>\n\n", "content": "

    This page describes nice ways of embedding source code in a page.

    \n\n<h2 id=\"inline-code-snippets\">Inline code snippets</h2>\n\n

    If you just want to write a short snippet of code as part of a sentence,\nsurround the code in backtick symbols (`).

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">Type `print('Hello world!')` and save as `hello.py`.</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n

    Type <code class=\"language-plaintext highlighter-rouge\">print('Hello world!')</code> and save as <code class=\"language-plaintext highlighter-rouge\">hello.py</code>.

    \n\n
    \n</div>\n</div>\n\n<h2 id=\"code-fences\">Code fences</h2>\n\n

    A “code fence” is three backtick symbols (```) preceding your\ncode, and another three concluding it. Optionally, you can write the name of\nthe language in small case next to the leading fence to declare syntax\nhighlighting is desired with the stated language.

    \n\n<h3 id=\"java-example\">Java example</h3>\n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">```java\nImage3DUniverse univ = new Image3DUniverse();\nuniv.show();\nuniv.addMesh(yourImagePlus, null, \"somename\", 50,\n  new boolean[] {true, true, true}, 2);\n```</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <div class=\"language-java highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\"><span class=\"nc\">Image3DUniverse</span> <span class=\"n\">univ</span> <span class=\"o\">=</span> <span class=\"k\">new</span> <span class=\"nc\">Image3DUniverse</span><span class=\"o\">();</span>\n<span class=\"n\">univ</span><span class=\"o\">.</span><span class=\"na\">show</span><span class=\"o\">();</span>\n<span class=\"n\">univ</span><span class=\"o\">.</span><span class=\"na\">addMesh</span><span class=\"o\">(</span><span class=\"n\">yourImagePlus</span><span class=\"o\">,</span> <span class=\"kc\">null</span><span class=\"o\">,</span> <span class=\"s\">\"somename\"</span><span class=\"o\">,</span> <span class=\"mi\">50</span><span class=\"o\">,</span>\n <span class=\"k\">new</span> <span class=\"kt\">boolean</span><span class=\"o\">[]</span> <span class=\"o\">{</span><span class=\"kc\">true</span><span class=\"o\">,</span> <span class=\"kc\">true</span><span class=\"o\">,</span> <span class=\"kc\">true</span><span class=\"o\">},</span> <span class=\"mi\">2</span><span class=\"o\">);</span>\n</pre>
    </div>\n\n </div>\n</div>\n</div>\n\n<h3 id=\"python-example\">Python example</h3>\n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\">```python\ndef update_progress(progress):\n    barLength = 10 # length of progress bar\n    block = int(round(barLength*progress))\n    text = f'\\rPercent complete: ' +\n      f'[{\"#\"*block + \"-\"*(barLength-block)}] ' +\n      f'{progress*100}%'\n    sys.stdout.write(text)\n    sys.stdout.flush()\n```</code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <div class=\"language-python highlighter-rouge\"><div class=\"highlight\"><pre class=\"highlight\"><span class=\"k\">def</span> <span class=\"nf\">update_progress</span><span class=\"p\">(</span><span class=\"n\">progress</span><span class=\"p\">):</span>\n <span class=\"n\">barLength</span> <span class=\"o\">=</span> <span class=\"mi\">10</span> <span class=\"c1\"># length of progress bar\n</span> <span class=\"n\">block</span> <span class=\"o\">=</span> <span class=\"nb\">int</span><span class=\"p\">(</span><span class=\"nb\">round</span><span class=\"p\">(</span><span class=\"n\">barLength</span><span class=\"o\">*</span><span class=\"n\">progress</span><span class=\"p\">))</span>\n <span class=\"n\">text</span> <span class=\"o\">=</span> <span class=\"sa\">f</span><span class=\"s\">'</span><span class=\"se\">\\r</span><span class=\"s\">Percent complete: '</span> <span class=\"o\">+</span>\n <span class=\"sa\">f</span><span class=\"s\">'[</span><span class=\"si\">{</span><span class=\"s\">\"#\"</span><span class=\"o\">*</span><span class=\"n\">block</span> <span class=\"o\">+</span> <span class=\"s\">\"-\"</span><span class=\"o\">*</span><span class=\"p\">(</span><span class=\"n\">barLength</span><span class=\"o\">-</span><span class=\"n\">block</span><span class=\"p\">)</span><span class=\"si\">}</span><span class=\"s\">] '</span> <span class=\"o\">+</span>\n <span class=\"sa\">f</span><span class=\"s\">'</span><span class=\"si\">{</span><span class=\"n\">progress</span><span class=\"o\">*</span><span class=\"mi\">100</span><span class=\"si\">}</span><span class=\"s\">%'</span>\n <span class=\"n\">sys</span><span class=\"p\">.</span><span class=\"n\">stdout</span><span class=\"p\">.</span><span class=\"n\">write</span><span class=\"p\">(</span><span class=\"n\">text</span><span class=\"p\">)</span>\n <span class=\"n\">sys</span><span class=\"p\">.</span><span class=\"n\">stdout</span><span class=\"p\">.</span><span class=\"n\">flush</span><span class=\"p\">()</span>\n</pre>
    </div>\n\n </div>\n</div>\n</div>\n\n<h2 id=\"highlight-directive\">Highlight directive</h2>\n\n

    Alternately, there is a <code class=\"language-plaintext highlighter-rouge\">highlight</code> Liquid directive you can try.\nIt looks like this:

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\"><span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">highlight</span><span class=\"w\"> </span>java<span class=\"w\"> </span><span class=\"p\">%}</span>\nlog.info(\"You're a wizard, Harry!\");\nlog.error(\"I'm a what?\");\n<span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">endhighlight</span><span class=\"w\"> </span><span class=\"p\">%}</span></code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n <figure class=\"highlight\">
    <code class=\"language-java\" data-lang=\"java\"><span class=\"n\">log</span><span class=\"o\">.</span><span class=\"na\">info</span><span class=\"o\">(</span><span class=\"s\">\"You're a wizard, Harry!\"</span><span class=\"o\">);</span>\n<span class=\"n\">log</span><span class=\"o\">.</span><span class=\"na\">error</span><span class=\"o\">(</span><span class=\"s\">\"I'm a what?\"</span><span class=\"o\">);</span></code>
    </figure>\n\n
    \n</div>\n</div>\n\n

    The <code class=\"language-plaintext highlighter-rouge\">highlight</code> directive and code fences are separate features, but\nfunctionally very similar. If code fences are not working as you like,\ngive the <code class=\"language-plaintext highlighter-rouge\">highlight</code> directive a try to see if it does any better.

    \n\n<h2 id=\"embedding-code-from-github\">Embedding code from GitHub</h2>\n\n

    If you have a block of code in a GitHub repository, you can embed it\ndynamically into the page using the <code class=\"language-plaintext highlighter-rouge\">github-embed</code> include. This approach has\nthe advantage of avoiding copy-paste skew as the code evolves over time.

    \n\n<div class=\"code-example\">\n
    \n

    Code

    \n\n<figure class=\"highlight\">
    <code class=\"language-liquid\" data-lang=\"liquid\"><span class=\"p\">{%</span><span class=\"w\"> </span><span class=\"nt\">include</span><span class=\"w\"> </span><span class=\"nv\">github-embed</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">org</span><span class=\"o\">=</span><span class=\"s2\">\"duckythescientist\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">repo</span><span class=\"o\">=</span><span class=\"s2\">\"obfuscatedLife\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">branch</span><span class=\"o\">=</span><span class=\"s2\">\"original\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">path</span><span class=\"o\">=</span><span class=\"s2\">\"life.c\"</span><span class=\"err\">\n</span><span class=\"w\">     </span><span class=\"na\">label</span><span class=\"o\">=</span><span class=\"s2\">\"Conway's Obfuscated Game of Life\"</span><span class=\"w\"> </span><span class=\"p\">%}</span></code>
    </figure>\n\n
    \n
    \n

    Result

    \n<div class=\"shadowed-box\">\n\n

    <a href=\"https://github.com/duckythescientist/obfuscatedLife/blob/original/life.c\">Conway’s Obfuscated Game of Life</a>
    <script src=\"https://emgithub.com/embed.js?target=https%3A%2F%2Fgithub.com%2Fduckythescientist%2FobfuscatedLife%2Fblob%2Foriginal%2Flife.c%23L1-99999&style=github&showBorder=on&showLineNumbers=on&showFileMeta=on&showCopy=on\"></script>

    \n\n
    \n</div>\n</div>\n\n

    Other parameters supported by the <code class=\"language-plaintext highlighter-rouge\">github-embed</code> include are:

    \n\n\n \n \n <th style=\"text-align: left\">Parameter</th>\n <th style=\"text-align: left\">Description</th>\n <th style=\"text-align: left\">Values</th>\n \n \n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">line-start</code></td>\n <td style=\"text-align: left\">First line to embed</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">>= 1</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">line-end</code></td>\n <td style=\"text-align: left\">Last line to embed</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">>= 1</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">label</code></td>\n <td style=\"text-align: left\">Hyperlinked label to place before the code</td>\n <td style=\"text-align: left\">any string</td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">style</code></td>\n <td style=\"text-align: left\">Syntax highlighting color scheme</td>\n <td style=\"text-align: left\">various*</td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-border</code></td>\n <td style=\"text-align: left\">Whether to draw a border around the frame</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-line-numbers</code></td>\n <td style=\"text-align: left\">Whether to number the lines</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-file-meta</code></td>\n <td style=\"text-align: left\">Whether to include the footer with links</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">show-copy</code></td>\n <td style=\"text-align: left\">Whether to include the Copy button on mouseover</td>\n <td style=\"text-align: left\"><code class=\"language-plaintext highlighter-rouge\">true</code> or <code class=\"language-plaintext highlighter-rouge\">false</code></td>\n \n \n \n
    Default
    <code class=\"language-plaintext highlighter-rouge\">1</code>
    <code class=\"language-plaintext highlighter-rouge\">99999</code>
    no label
    <code class=\"language-plaintext highlighter-rouge\">github</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    <code class=\"language-plaintext highlighter-rouge\">true</code>
    \n\n

    * Valid style values are:

    \n<ul style=\"display: flex; flex-wrap: wrap; list-style: none;\">\n
  • a11y-dark
  • \n
  • a11y-light
  • \n
  • agate
  • \n
  • an-old-hope
  • \n
  • androidstudio
  • \n
  • arduino-light
  • \n
  • arta
  • \n
  • ascetic
  • \n
  • atelier-cave-dark
  • \n
  • atelier-cave-light
  • \n
  • atelier-dune-dark
  • \n
  • atelier-dune-light
  • \n
  • atelier-estuary-dark
  • \n
  • atelier-estuary-light
  • \n
  • atelier-forest-dark
  • \n
  • atelier-forest-light
  • \n
  • atelier-heath-dark
  • \n
  • atelier-heath-light
  • \n
  • atelier-lakeside-dark
  • \n
  • atelier-lakeside-light
  • \n
  • atelier-plateau-dark
  • \n
  • atelier-plateau-light
  • \n
  • atelier-savanna-dark
  • \n
  • atelier-savanna-light
  • \n
  • atelier-seaside-dark
  • \n
  • atelier-seaside-light
  • \n
  • atelier-sulphurpool-dark
  • \n
  • atelier-sulphurpool-light
  • \n
  • atom-one-dark
  • \n
  • atom-one-dark-reasonable
  • \n
  • atom-one-light
  • \n
  • codepen-embed
  • \n
  • color-brewer
  • \n
  • darcula
  • \n
  • dark
  • \n
  • default
  • \n
  • docco
  • \n
  • dracula
  • \n
  • far
  • \n
  • foundation
  • \n
  • github
  • \n
  • github-gist
  • \n
  • gml
  • \n
  • googlecode
  • \n
  • gradient-dark
  • \n
  • grayscale
  • \n
  • gruvbox-dark
  • \n
  • gruvbox-light
  • \n
  • hopscotch
  • \n
  • hybrid
  • \n
  • idea
  • \n
  • ir-black
  • \n
  • isbl-editor-dark
  • \n
  • isbl-editor-light
  • \n
  • kimbie.dark
  • \n
  • kimbie.light
  • \n
  • lightfair
  • \n
  • magula
  • \n
  • mono-blue
  • \n
  • monokai
  • \n
  • monokai-sublime
  • \n
  • night-owl
  • \n
  • nord
  • \n
  • obsidian
  • \n
  • ocean
  • \n
  • paraiso-dark
  • \n
  • paraiso-light
  • \n
  • purebasic
  • \n
  • qtcreator_dark
  • \n
  • qtcreator_light
  • \n
  • railscasts
  • \n
  • rainbow
  • \n
  • routeros
  • \n
  • shades-of-purple
  • \n
  • solarized-dark
  • \n
  • solarized-light
  • \n
  • sunburst
  • \n
  • tomorrow
  • \n
  • tomorrow-night
  • \n
  • tomorrow-night-blue
  • \n
  • tomorrow-night-bright
  • \n
  • tomorrow-night-eighties
  • \n
  • vs
  • \n
  • vs2015
  • \n
  • xcode
  • \n
  • xt256
  • \n
  • zenburn
  • \n</ul>\n", "url": "/editing/code", "draft": false, "categories": [ ], "title": "Source Code", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "code", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/debugging", "collection": "pages", "next": { "path": "_pages/editing/headers.md", "relative_path": "_pages/editing/headers.md", "excerpt": "

    This page showcases the look of different header levels.

    \n\n", "previous": { "path": "_pages/editing/debugging.md", "relative_path": "_pages/editing/debugging.md", "excerpt": "

    The best way to collect debugging information is to <a href=\"/editing/advanced\">build the site locally</a>. However if that isn’t an option, this page documents tags which can be helpful.

    \n\n", "previous": { "path": "_pages/editing/code.md", "relative_path": "_pages/editing/code.md", "id": "/editing/code", "collection": "pages", "url": "/editing/code", "draft": false, "categories": [ ], "title": "Source Code", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "code", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/debugging", "collection": "pages", "next": { "path": "_pages/editing/headers.md", "relative_path": "_pages/editing/headers.md", "id": "/editing/headers", "collection": "pages", "url": "/editing/headers", "draft": false, "categories": [ ], "title": "Headers", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "headers", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": null, "content": "The best way to collect debugging information is to [build the site locally](/editing/advanced). However if that isn't an option, this page documents tags which can be helpful.\n\n## Echo\n\nThis `echo` include just prints its arguments, for debugging/learning purposes. This can be helpful in understanding Liquid syntax and how strings are being read internally by an `include`.\n\nArguments are printed as a comma-separated list of `\"argument\"==>\"value\"` pairs.\n\nNote that liquid allows the passing of [arbitrary arguments](https://jekyllrb.com/docs/includes/) to `include` templates. All these arguments will be stored, but won't have any effect unless the `include`'s [source](https://github.com/micro-manager/micro-manager.github.io/tree/main/_includes) actually does something with those arguments.\n\n{% highlight liquid %}{% raw %}{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}{% endraw %}{% endhighlight %}\n{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}\n\n### What's in a `page`?\n\n{% include notice icon=\"tech\" content=\"Ever wonder what all is part of the `page` data structure? Let's find out!\n\n(You can also do this with the `site` data structure, but be warned: the output will include every page body across the whole site!)\" %}\n\n{% highlight liquid %}{% raw %}{% include echo p=page %}{% endraw %}{% endhighlight %}\n{% include echo p=page %}\n", "url": "/editing/debugging", "draft": false, "categories": [ ], "title": "Debugging", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "debugging", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/headers", "collection": "pages", "next": { "path": "_pages/editing/icons.md", "relative_path": "_pages/editing/icons.md", "excerpt": "

    This page demonstrates how to use the <code class=\"language-plaintext highlighter-rouge\">icon</code> include tag.

    \n\n", "previous": { "path": "_pages/editing/headers.md", "relative_path": "_pages/editing/headers.md", "id": "/editing/headers", "collection": "pages", "url": "/editing/headers", "draft": false, "categories": [ ], "title": "Headers", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "headers", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "id": "/editing/icons", "collection": "pages", "next": { "path": "_pages/editing/images.md", "relative_path": "_pages/editing/images.md", "id": "/editing/images", "collection": "pages", "url": "/editing/images", "draft": false, "categories": [ ], "title": "Images", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "images", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": null, "content": "This page demonstrates how to use the `icon` include tag.\n\n## Usage\n\nSpecify an icon by name.\n\n{% raw %}\n```\n{% include icon name='info' %}\n```\n{% endraw %}\n\n{% include icon name='info' %}\n\n{% raw %}\n```\n{% include icon name='ImageJ' %}\n```\n{% endraw %}\n\n{% include icon name='ImageJ' %}\n\nOptionally, override the icon size (default is `48px`):\n\n{% raw %}\n```\n{% include icon name='ImageJ' size='96px' %}\n```\n{% endraw %}\n\n{% include icon name='ImageJ' size='96px' %}\n\nUse `size=x96px` to set the height instead of the width:\n\n{% raw %}\n```\n{% include icon name='ImageJ' size='x96px' %}\n```\n{% endraw %}\n\n{% include icon name='ImageJ' size='x96px' %}\n\nYou can also override the horizontal alignment:\n\n{% raw %}\n```\n{% include icon name='Linux' size='96px' align='left' %}\n```\n{% endraw %}\n\n{% include icon name='Linux' size='96px' align='left' %}\nAlpha \nBeta \nGamma\n", "url": "/editing/icons", "draft": false, "categories": [ ], "title": "Icons", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "icons", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": null, "content": "This page showcases the look of different header levels.\n\nIn Markdown, you make a header by prefacing the section title with\na number of `#` symbols, up to a maximum of six (for `
    `).\n\nUsing headers to delineate content sections has some advantages:\n\n* Headers will automatically have a slugified `id` added,\n to facilitate linking to particular sections using anchors.\n* A table of contents (in the right sidebar by default) will be automatically\n generated according to the declared headers—as long as there are at\n least three of them.\n\n# h1 headers\n\nInvoke header level 1 by writing:\n```markdown\n# Lorem\n```\n\n## h2 headers\n\nInvoke header level 2 by writing:\n```markdown\n## Ipsum\n```\n\n### h3 headers\n\nInvoke header level 3 by writing:\n```markdown\n### Flotsam and Jetsum\n```\n\n#### h4 headers\n\nInvoke header level 4 by writing:\n```markdown\n#### Wingardium Leviosa\n```\n\n##### h5 headers\n\nInvoke header level 5 by writing:\n```markdown\n##### Adamantium\n```\n\n###### h6 headers\n\nInvoke header level 6 by writing:\n```markdown\n###### Plotdevicium\n```\n\n# Closing remarks\n\nThis section here at the bottom exists merely to trigger the table of contents\nto generate on this page, so that you can see how it looks. Cheers!\n", "url": "/editing/headers", "draft": false, "categories": [ ], "title": "Headers", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "headers", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }, "output": null, "content": "The best way to collect debugging information is to [build the site locally](/editing/advanced). However if that isn't an option, this page documents tags which can be helpful.\n\n## Echo\n\nThis `echo` include just prints its arguments, for debugging/learning purposes. This can be helpful in understanding Liquid syntax and how strings are being read internally by an `include`.\n\nArguments are printed as a comma-separated list of `\"argument\"==>\"value\"` pairs.\n\nNote that liquid allows the passing of [arbitrary arguments](https://jekyllrb.com/docs/includes/) to `include` templates. All these arguments will be stored, but won't have any effect unless the `include`'s [source](https://github.com/micro-manager/micro-manager.github.io/tree/main/_includes) actually does something with those arguments.\n\n{% highlight liquid %}{% raw %}{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}{% endraw %}{% endhighlight %}\n{% include echo content=\"This is the content argument\" bracket=\"what if I pass {}?\" gorilla=\"Why do we have a gorilla argument?\" %}\n\n### What's in a `page`?\n\n{% include notice icon=\"tech\" content=\"Ever wonder what all is part of the `page` data structure? Let's find out!\n\n(You can also do this with the `site` data structure, but be warned: the output will include every page body across the whole site!)\" %}\n\n{% highlight liquid %}{% raw %}{% include echo p=page %}{% endraw %}{% endhighlight %}\n{% include echo p=page %}\n", "url": "/editing/debugging", "draft": false, "categories": [ ], "title": "Debugging", "layout": "page", "section": "Support:Editing the Wiki", "nav-links": true, "slug": "debugging", "ext": ".md", "tags": [ ], "date": "2024-08-29 18:18:59 +0000" }}</p>