j1-template 2022.2.3 → 2022.3.2

data/lib/starter_web/pages/public/jupyter/examples/j1-circular-times-table.adoc

@@ -0,0 +1,135 @@
+---
+title:                                  Times Tables
+tagline:                                visualize patterns
+date:                                   2022-03-28 00:00:00
+description: >
+                                        The package nbinteract aims to enable authors and educators to create and
+                                        share interactive web pages easily. Interactive explanations of concepts are
+                                        useful for communicating and explaining tricky concepts.
+keywords: >
+                                        opensource, free, load, download, start, starter, example,
+                                        high, easy, use, secure, encrypt, standard, popular,
+                                        generate, create, learn, distribute, publish, deploy,
+                                        beginner, advanced, expert, student, learner, writer, reader, visitor
+                                        framework, toolkit, integration, extension, module, api,
+                                        dynamic, static, generator, client, server, internet, local, localhost
+                                        page, web, website, webdesign, material, design, responsive,
+                                        javascript, nodejs, ruby, windows, linux, osx, mac, os,
+                                        http, https, html, html5, css, scss, style,
+                                        browser, firefox, chrome, edge, opera, safari,
+                                        configuration, generator, navigation, menu, dropdown, fab, action, button
+                                        application, interface, provider, api, repository,
+                                        cookie, language, translation, gdpr, dsgvo, privacy,
+                                        asciidoc, aciidoctor, bootstrap, jekyll, liquid,
+                                        hyvor, disqus, git, github, netlify, heroku, apple, microsoft,
+                                        provider, service, internet, support,
+                                        google, analytics, advertising, search, console, silverlight, score,
+                                        j1, template, jekyllone, comment,
+                                        python, jupyter, notebook, textbook, api, app, nbinteract,
+                                        nbi, integration, binder, binderhub, jupyterhub
+
+categories:                             [ Software, Python ]
+tags:                                   [ Binder, Jupyter, Notebooks ]
+
+scrollbar:                              false
+fab_menu_id:                            open_toc_reload
+personalization:                        true
+
+permalink:                              /pages/public/jupyter/textbooks/j1-circular-times-table/
+regenerate:                             false
+
+resources:                              [ nbinteract, rouge ]
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/pages/nbinteract/mandelbrot-menge-1920x1200.jpg
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+:binder-badges-enabled:                 true
+:binder-app-launch--tree:               https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?urlpath=/tree
+:binder-app-launch--notebook:           https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?filepath=notebooks/j1/j1_circular_times_table.ipynb
+:times-tables-visualization:            https://elc.github.io/posts/times-tables/
+
+//  Load Liquid procedures
+// -----------------------------------------------------------------------------
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="global" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// image:/assets/images/badges/myBinder.png[Binder, link="https://mybinder.org/", {browser-window--new}]
+// image:/assets/images/badges/docsBinder.png[Binder, link="https://mybinder.readthedocs.io/en/latest/", {browser-window--new}]
+// See: https://towardsdatascience.com/ordinal-differential-equation-ode-in-python-8dc1de21323b
+
+ifeval::[{binder-badges-enabled} == true]
+image:/assets/images/badges/notebookBinder.png[Binder, link="{binder-app-launch--notebook}", {browser-window--new}]
+image:https://mybinder.org/badge_logo.svg[Binder, link="{binder-app-launch--tree}", {browser-window--new}]
+endif::[]
+
+CAUTION: Each interactive element presented on this page uses *time-consuming*
+operations that take a while to finish. The elements are built through a
+backend in the cloud. Please be patient to see the results.
+
+First, let's introduce the video from _Mathologer_. This video creates very
+nice patterns from _Times Tables_. Everybody knows them from primary school.
+It's something like this:
+
+.Table of *Two* (excerpt)
+[cols="6a,6a", options="header", width="100%", role="rtable mt-3"]
+|===
+|Factor |Value
+
+|`1 x 2`
+|2
+
+|`2 x 2`
+|4
+
+|`3 x 2`
+|6
+
+|`4 x 2`
+|8
+
+|===
+
+The idea, in general, is surprisingly simple, but the results are surprising.
+Please go for the video from _Mathologer_ first to catch the idea behind it.
+
+In this document, several scenarios using _Times Tables_ as a base to
+calculate plotted images are presented similar to the approach of
+what _Mathologer_ is doing:
+
+* a static but parametric version: you can change with sliders the values
+  and experiment by yourself.
+* an animated version to construct the image Line by Line: the factor
+  and the number of points is fixed, but each line is plotted per iteration
+* an animated version to construct the image Point by Point: the factor
+  and the lines are fixed, but each iteration increases the number of points
+* an animated version to construct the image Factor by Factor: the lines
+  and the number of points is fixed, but the factor increases per iteration.
+
+Start your journey on the power of Mathematics!
+
+NOTE: All examples are taken from
+link:{times-tables-visualization}[Times Tables Visualization - Finding Patterns, {browser-window--new}],
+and re-written for the use of module J1 NBI. Some text is used from the
+original post but re-written for clarity and simplicity.
+
+// textbook::circular_times_table[]
+textbook::j1_circular_times_table[]

data/lib/starter_web/pages/public/jupyter/examples/j1-interactive-widgets.adoc

@@ -60,11 +60,10 @@ resource_options:
 
 // Set (local) page attributes here
 // -----------------------------------------------------------------------------
-// :page--attr:                                   <attr-value>
-:binder-badges-enabled:                           true
-:binder-app-launch--tree:                         https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?urlpath=/tree
-:binder-app-launch--notebook:                     https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?filepath=notebooks/j1/j1_interactive.ipynb
-
+// :page--attr:                         <attr-value>
+:binder-badges-enabled:                 true
+:binder-app-launch--tree:               https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?urlpath=/tree
+:binder-app-launch--notebook:           https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?filepath=notebooks/j1/j1_interactive_widgets.ipynb
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -87,6 +86,10 @@ image:/assets/images/badges/notebookBinder.png[Binder, link="{binder-app-launch-
 image:https://mybinder.org/badge_logo.svg[Binder, link="{binder-app-launch--tree}", {browser-window--new}]
 endif::[]
 
+CAUTION: Each interactive element presented on this page uses *time-consuming*
+operations that take a while to finish. The elements are built through a
+backend in the cloud. Please be patient to see the results.
+
 Widgets are eventful python objects that have a representation in the browser,
 often as a control like a slider, textbox, etc. Widgets are used to build
 interactive GUIs for your notebooks, and to synchronize stateful and stateless

data/lib/starter_web/pages/public/jupyter/examples/j1-odes-in-python.adoc

@@ -1,5 +1,5 @@
 ---
-title:                                  ODEs in Python
+title:                                  ODEs with Python
 tagline:                                interactive evaluation
 date:                                   2022-03-28 00:00:00
 description: >
@@ -55,10 +55,11 @@ resource_options:
 
 // Set (local) page attributes here
 // -----------------------------------------------------------------------------
-// :page--attr:                                   <attr-value>
-:binder-badges-enabled:                           true
-:binder-app-launch--tree:                         https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?urlpath=/tree
-:binder-app-launch--notebook:                     https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?filepath=notebooks/j1/j1_odes_in_python.ipynb
+// :page--attr:                         <attr-value>
+:binder-badges-enabled:                 true
+:binder-app-launch--tree:               https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?urlpath=/tree
+:binder-app-launch--notebook:           https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?filepath=notebooks/j1/j1_odes_in_python.ipynb
+:odes-in-python:                        https://elc.github.io/posts/ordinary-differential-equations-with-python/
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -81,7 +82,11 @@ image:https://mybinder.org/badge_logo.svg[Binder, link="{binder-app-launch--tree
 endif::[]
 
 
-== ODEs in Python
+// See: https://elc.github.io/posts/ordinary-differential-equations-with-python/
+
+CAUTION: Each interactive element presented on this page uses *time-consuming*
+operations that take a while to finish. The elements are built through a
+backend in the cloud. Please be patient to see the results.
 
 An ordinary differential equation (often abbreviated to ODE) is one
 Differential equation where only derivatives of the desired function
@@ -96,4 +101,7 @@ describing the dynamics of the population of rabbits and foxes. Check how
 the animals depend on each other. Manipulate some parameters to see the
 influences on the rabbits and foxes population.
 
-textbook::j1_ode_selected[]
+NOTE: All examples are taken from
+link:{odes-in-python}[Ordinary Differential Equations (ODE) with Python, {browser-window--new}]
+
+textbook::j1_odes_in_python[]

data/lib/starter_web/pages/public/jupyter/examples/j1-testing-plotly.adoc

@@ -0,0 +1,94 @@
+---
+title:                                  Testing Plotly
+tagline:                                interactive evaluation
+date:                                   2022-03-28 00:00:00
+description: >
+                                        The package nbinteract aims to enable authors and educators to create and
+                                        share interactive web pages easily. Interactive explanations of concepts are
+                                        useful for communicating and explaining tricky concepts.
+keywords: >
+                                        opensource, free, load, download, start, starter, example,
+                                        high, easy, use, secure, encrypt, standard, popular,
+                                        generate, create, learn, distribute, publish, deploy,
+                                        beginner, advanced, expert, student, learner, writer, reader, visitor
+                                        framework, toolkit, integration, extension, module, api,
+                                        dynamic, static, generator, client, server, internet, local, localhost
+                                        page, web, website, webdesign, material, design, responsive,
+                                        javascript, nodejs, ruby, windows, linux, osx, mac, os,
+                                        http, https, html, html5, css, scss, style,
+                                        browser, firefox, chrome, edge, opera, safari,
+                                        configuration, generator, navigation, menu, dropdown, fab, action, button
+                                        application, interface, provider, api, repository,
+                                        cookie, language, translation, gdpr, dsgvo, privacy,
+                                        asciidoc, aciidoctor, bootstrap, jekyll, liquid,
+                                        hyvor, disqus, git, github, netlify, heroku, apple, microsoft,
+                                        provider, service, internet, support,
+                                        google, analytics, advertising, search, console, silverlight, score,
+                                        j1, template, jekyllone, comment,
+                                        python, jupyter, notebook, textbook, api, app, nbinteract,
+                                        nbi, integration, binder, binderhub, jupyterhub
+
+categories:                             [ Software, Python ]
+tags:                                   [ Binder, Jupyter, Notebooks ]
+
+scrollbar:                              false
+fab_menu_id:                            open_toc_reload
+personalization:                        true
+
+permalink:                              /pages/public/jupyter/textbooks/j1-testing-plotly/
+regenerate:                             true
+
+resources:                              [ nbinteract, require, rouge ]
+resource_options:
+  - attic:
+      padding_top:                      400
+      padding_bottom:                   50
+      opacity:                          0.5
+      slides:
+        - url:                          /assets/images/modules/attics/runner-1920x1200.jpg
+---
+
+// Page Initializer
+// =============================================================================
+// Enable the Liquid Preprocessor
+:page-liquid:
+
+// Set (local) page attributes here
+// -----------------------------------------------------------------------------
+// :page--attr:                         <attr-value>
+:binder-badges-enabled:                 true
+:binder-app-launch--tree:               https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?urlpath=/tree
+:binder-app-launch--notebook:           https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?filepath=notebooks/j1/j1_odes_in_python.ipynb
+
+//  Load Liquid procedures
+// -----------------------------------------------------------------------------
+{% capture load_attributes %}themes/{{site.template.name}}/procedures/global/attributes_loader.proc{%endcapture%}
+
+// Load page attributes
+// -----------------------------------------------------------------------------
+{% include {{load_attributes}} scope="global" %}
+
+
+// Page content
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// image:/assets/images/badges/myBinder.png[Binder, link="https://mybinder.org/", {browser-window--new}]
+// image:/assets/images/badges/docsBinder.png[Binder, link="https://mybinder.readthedocs.io/en/latest/", {browser-window--new}]
+// See: https://towardsdatascience.com/ordinal-differential-equation-ode-in-python-8dc1de21323b
+
+ifeval::[{binder-badges-enabled} == true]
+image:/assets/images/badges/notebookBinder.png[Binder, link="{binder-app-launch--notebook}", {browser-window--new}]
+image:https://mybinder.org/badge_logo.svg[Binder, link="{binder-app-launch--tree}", {browser-window--new}]
+endif::[]
+
+CAUTION: Each interactive element presented on this page uses *time-consuming*
+operations that take a while to finish. The elements are built through a
+backend in the cloud. Please be patient to see the results.
+
+== Plotly
+
+lorem:sentences[5]
+
+lorem:sentences[3]
+
+
+textbook::j1_testing_plotly[]

data/lib/starter_web/pages/public/jupyter/examples/j1_climate-change-forecast.adoc

@@ -56,10 +56,10 @@ resource_options:
 
 // Set (local) page attributes here
 // -----------------------------------------------------------------------------
-// :page--attr:                                   <attr-value>
-:binder-badges-enabled:                           true
-:binder-app-launch--tree:                         https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?urlpath=/tree
-:binder-app-launch--notebook:                     https://mybinder.org/v2/gh/jekyll-one/nbinteract-notebooks/main?filepath=notebooks/j1/j1_climate_change_forecast.ipynb
+// :page--attr:                         <attr-value>
+:binder-badges-enabled:                 true
+:binder-app-launch--tree:               https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?urlpath=/tree
+:binder-app-launch--notebook:           https://mybinder.org/v2/gh/jekyll-one/j1-binder-repo/main?filepath=notebooks/j1/j1_climate_change_forecast.ipynb
 
 //  Load Liquid procedures
 // -----------------------------------------------------------------------------
@@ -80,15 +80,15 @@ image:/assets/images/badges/notebookBinder.png[Binder, link="{binder-app-launch-
 image:https://mybinder.org/badge_logo.svg[Binder, link="{binder-app-launch--tree}", {browser-window--new}]
 endif::[]
 
+CAUTION: If the J1 NBI module detects *non-interactive* textbooks, the
+NBI module adapter does *not* start a Binder service for an external
+computational environment.
+
 This textbook is an example of a *non-interactive* Jupyter notebook (JN).
 Jupyter Notebooks don't necessarily need to contain *interactive* widgets.
 The CLI `nbinteract` can export all types of (Python-based) notebooks to
 an (HTML) textbooks.
 
-NOTE: If the J1 NBI module detects non-interactive textbooks, the module
-adapter does *not* start the Binder service for an external computational
-environment.
-
 == Climate change forecasting
 
 Predicting climate change is a very difficult business. The calculations are