jupyter: table improvements, docs (#1370)

Author: MykolaGolubyev

znai-docs/znai/layout/jupyter-notebook-two-sides.md

@@ -9,7 +9,7 @@ If page `type` is set to `two-sides` you will get automatic split between code a
 
 Note: Content below is included using `include-jupyter`
 
-:include-jupyter: snippets/jupyter/simple-notebook.ipynb
+:include-jupyter: snippets/jupyter/notebook.ipynb
 
 # Story First
 
@@ -18,4 +18,4 @@ side and a reader can focus on the story itself.
 
     :include-jupyter: notebook.ipynb {storyFirst: true}
 
-:include-jupyter: src/test/resources/notebook-with-markdown-story.ipynb {storyFirst: true}
+:include-jupyter: ../snippets/jupyter/notebook.ipynb {storyFirst: true}

znai-docs/znai/snippets/jupyter-notebook.md

@@ -1,37 +1,47 @@
-# Code and Output
+# Include Notebook Section
 
-Use `include-jupyter` to include [Jupyter](https://jupyter.org/) notebook inside your documentation. 
+Use `include-jupyter` to include a jupyter notebook or one of its parts.
+Here is an example of a notebook:
 
-    :include-jupyter: jupyter/simple-notebook.ipynb
-    
-:include-jupyter: jupyter/simple-notebook.ipynb
+:include-image: jupyter/notebook.png {fit: true, border: true}
 
-Note: Remember that you can define lookup paths for files like notebooks inside [lookup-paths](flow/lookup-paths) file, so you don't have
-to copy and paste notebooks to your documentation directory.
+To include one of its sections use,
 
-# Seamless Markdown Integration
+```
+:include-jupyter: jupyter/notebook.ipynb {
+    includeSection: ["Loading Data From CSV"]
+}
+```
 
-Markdown from your notebook will be seamlessly integrated into your current page. First level `# headers` will
-become part of Table Of Contents and part of a search unit. 
+Markdown cells will be seamlessly integrated with the current page. 
+Top level headers become this page top level header.
 
-:include-image: jupyter/notebook.png {fit: true}
+Note: without `includeSection`, the entire notebook content will be added.
 
-    :include-jupyter: notebook-with-markdown-story.ipynb
+:include-jupyter: jupyter/notebook.ipynb {
+    includeSection: ["Loading Data From CSV"]
+}
 
-Note: below text is auto generated, including the **Panda** section 
-:include-jupyter: src/test/resources/notebook-with-markdown-story.ipynb
+Note: Remember that you can define lookup paths for files like notebooks inside [lookup-paths](flow/lookup-paths) file, so you don't have
+to copy and paste notebooks to your documentation directory.
 
-# Include Only Specified Sections
+# Exclude Section Title
 
-Use `includeSection` to select which sections of the notebook to include.
+Use `excludeSectionTitle` to exclude section title. It can be useful when you 
+want to use section titles as example separators to be included into your guides.
 
 ```
-:include-jupyter: notebook.ipynb {
-    includeSection: ["Section One"; "Section Three"], 
+:include-jupyter: jupyter/notebook.ipynb {
+    includeSection: ["Average Prcing By Genre"],
     excludeSectionTitle: true
 }
 ```
 
+:include-jupyter: jupyter/notebook.ipynb {
+    includeSection: ["Average Pricing By Genre"],
+    excludeSectionTitle: true
+}
+
 # Two Sides
 
 You will learn about the [Two Sides Layout](layout/two-sides-pages) in the Layout section. 

znai-docs/znai/snippets/jupyter/games.csv

@@ -0,0 +1,5 @@
+genre,title,price
+RPG,Witcher 3,20.0
+FPS,Doom,39.0 
+Strategy, War Craft,10.0
+Cards, Balatro,5.0

znai-docs/znai/snippets/jupyter/notebook.ipynb

@@ -66,3 +66,7 @@
 .jupyter-html tbody tr:last-child td {
     border-bottom: none;
 }
+
+.jupyter-html .dataframe tbody td {
+    text-align: right;
+}