deepthy-dileep · nsdevaraj · Jun 3, 2025 · Jun 3, 2025 · Jun 12, 2025 · Dec 15, 2025
diff --git a/Makefile b/Makefile
@@ -18,46 +18,34 @@ COVER_IMAGE := images/cover.jpg
 COVER_IMAGE_EPUB := images/cover.jpg
 HIGHLIGHT := highlight/pygments.theme
 CSS_FILE = styles.css
-EBOOK_CONVERT := /Volumes/Extreme\ SSD/Applications/calibre.app/Contents/MacOS/ebook-convert
+EBOOK_CONVERT := /Applications/calibre.app/Contents/MacOS/ebook-convert
 
 # ARGS
 PDF_ARGS = -f markdown-raw_tex \
 		   --pdf-engine=xelatex \
-		   --pdf-engine-opt=-shell-escape \
 		   -V geometry:margin=1in \
 		   -V papersize:a4 \
 		   -V documentclass=book \
 		   -V colorlinks \
 		   -V urlcolor=NavyBlue \
-		   --filter /Users/devarajns/Library/Python/3.9/bin/pandoc-latex-environment \
+		   --filter .venv/bin/pandoc-latex-environment \
 		   --variable linestretch=1.2  \
 		   --include-before-body others/cover.tex \
 		   -V header-includes="\\usepackage{fontspec} \
-			\\usepackage{graphicx} \
-			\\usepackage{caption} \
-			\\usepackage{float} \
-		   		\\usepackage{wallpaper} \
-				\\setmainfont[Path=$(CURRENT_DIR)/fonts/, Extension=.ttf, UprightFont=Merriweather-Regular, BoldFont=Merriweather-Bold, ItalicFont=Merriweather-Italic]{Merriweather} \
-				\\setsansfont[Path=$(CURRENT_DIR)/fonts/, Extension=.ttf, UprightFont=OpenSans-Regular, BoldFont=OpenSans-Bold, ItalicFont=OpenSans-Italic]{OpenSans} \
+				\\usepackage{wallpaper} \
+				\\setmainfont{Merriweather}[Path=./fonts/,Extension=.ttf,UprightFont=*-Regular,BoldFont=*-Bold,ItalicFont=*-Italic] \
+				\\setsansfont{OpenSans}[Path=./fonts/,Extension=.ttf,UprightFont=*-Regular,BoldFont=*-Bold,ItalicFont=*-Italic,BoldItalicFont=*-BoldItalic] \
 				\\usepackage{titlesec} \
 				\\titleformat{\\chapter}[display]{\\normalfont\\bfseries\\large}{\\thechapter}{10pt}{\\raggedright} \
 				\\titlespacing*{\\chapter}{0pt}{0pt}{10pt} \
+					\\usepackage{graphicx} \
 					\\usepackage{fancyhdr} \
-					\\usepackage{xcolor} \
-					\\definecolor{purplebackground}{HTML}{8A6BAC} \
 					\\pagestyle{fancy} \
 					\\fancyhf{} \
-					\\fancyfoot[C]{\\colorbox{purplebackground}{\\textcolor{white}{\\leftmark}}} \
-					\\fancyhead[R]{\\colorbox{purplebackground}{\\textcolor{white}{\\thepage}}} \
-					\\fancyhead[L]{\\colorbox{purplebackground}{\\textcolor{white}{Inforiver Analytics+}}} \
+					\\fancyfoot[C]{\\leftmark} \
+					\\fancyhead[R]{\\thepage} \
 					\\renewcommand{\\headrulewidth}{0pt} \
-					\\renewcommand{\\footrulewidth}{0.4pt} \
-					\\usepackage{pagecolor} \
-					\\pagecolor{white} \
-					\\usepackage{mdframed} \
-					\\newmdenv[linecolor=purplebackground,linewidth=2pt,topline=true,bottomline=true,leftline=true,rightline=true,innerleftmargin=15pt,innerrightmargin=15pt,innertopmargin=15pt,innerbottommargin=15pt]{customframe} \
-					\\AtBeginDocument{\\begin{customframe}} \
-					\\AtEndDocument{\\end{customframe}}" \
+					\\renewcommand{\\footrulewidth}{0.4pt}" \
 		   $(ARGS) \
 		   $(METADATA_ARG)
 
@@ -84,14 +72,6 @@ all: output output/book.pdf output/html-epub
 
 pdf: output output/book.pdf
 
-# Generate PDF with image placeholders to avoid LaTeX errors
-pdf-no-images: output
-	./fix-pdf.sh
-
-# Generate PDF with optimized images
-pdf-with-images: output
-	./generate-pdf-with-images.sh
-
 epub: output output/book.epub
 
 latex: output output/book.tex
@@ -104,7 +84,7 @@ output:
 	@mkdir -p ./output
 
 output/%.pdf: Makefile $(CHAPTERS) | output
-	pandoc $(CHAPTERS) $(PDF_ARGS) --resource-path=.:images --wrap=none -o $@
+	pandoc $(CHAPTERS) $(PDF_ARGS) -o $@
 
 output/%.epub: Makefile $(CHAPTERS) $(FONTS) $(HIGHLIGHT) $(COVER_IMAGE) | output
 	pandoc $(CHAPTERS) $(ARGS) $(HIGHLIGHT_ARGS) $(EPUB_ARGS) -o $@
@@ -116,8 +96,8 @@ output/%.html: Makefile $(CHAPTERS) | output
 	pandoc $(CHAPTERS) $(HTML_ARGS) -s -o $@
 
 output/html-epub: Makefile $(CHAPTERS) | output
-	pandoc $(CHAPTERS) $(HTML_ARGS) -s -o output/book.html
-	$(EBOOK_CONVERT) output/book.html output/book.epub --extra-css styles.css --embed-all-fonts --cover $(COVER_IMAGE_EPUB) --level1-toc //h:h1 --level2-toc //h:h2 --level3-toc //h:h3
+	pandoc $(CHAPTERS) $(HTML_ARGS_FOR_EPUB) -s -o output/book.html
+	$(EBOOK_CONVERT) output/book.html output/book.epub --chapter //h:h1 --extra-css styles.css --embed-all-fonts --cover $(COVER_IMAGE_EPUB) --level1-toc //h:h1 --level2-toc //h:h2 --level3-toc //h:h3
 
 clean: phony
 	@rm -rf ./output
@@ -127,4 +107,4 @@ open-pdf: phony output/book.pdf
 	zathura output/book.pdf &
 
 open-epub: phony output/book.epub
-	ebook-viewer output/book.epub &
+	ebook-viewer output/book.epub &
diff --git a/README.md b/README.md
@@ -11,3 +11,9 @@ You need to have installed:
 * [pandoc-latex-environment](https://github.com/chdemko/pandoc-latex-environment)
 
 If you have a problem or a question, please open a new issue and try to be as descriptive as possible.
+brew install make
+brew install pandoc
+brew install calibre 
+brew install --cask basictex
+pipx install pandoc-latex-environment
+sudo tlmgr update --self && sudo tlmgr install xelatex fontspec environ trimspaces tcolorbox wallpaper titlesec
diff --git a/chapters/030_chapter1_introduction_to_inforiver_analytics_plus.md b/chapters/030_chapter1_introduction_to_inforiver_analytics_plus.md
@@ -4,7 +4,7 @@ Inforiver Analytics+ is a unified platform for data visualization, planning and
 
 Inforiver Analytics+ delivers key features that are available in other BI tools, but are missing in Power BI, thus facilitating migration and consolidation in the Microsoft stack.
 
-![Analytics Overview](https://github.com/user-attachments/assets/b7a5f235-95a1-4485-b8d8-bc324f1a24b3)
+![Analytics Overview](images/storyboarding-no-code-self-service-dashboards-tools.png)
 
 ## Core Components of Analytics+
 

diff --git a/chapters/050_chapter2_product_architecture_components.md b/chapters/050_chapter2_product_architecture_components.md
@@ -7,31 +7,31 @@ Inforiver Analytics+ features a sophisticated architecture designed to deliver e
 Inforiver Analytics+ is structured as a layered architecture that extends and enhances the Power BI environment:
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                   User Interface Layer                       │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐   │
-│  │ Configuration│  │ Visualization│  │ Interaction      │   │
-│  │ Panels       │  │ Canvas       │  │ Controls         │   │
-│  └──────────────┘  └──────────────┘  └──────────────────┘   │
-├─────────────────────────────────────────────────────────────┤
-│                 Business Logic Layer                         │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐   │
-│  │ Calculation  │  │ Formatting   │  │ Event            │   │
-│  │ Engine       │  │ Engine       │  │ Handler          │   │
-│  └──────────────┘  └──────────────┘  └──────────────────┘   │
-├─────────────────────────────────────────────────────────────┤
-│                 Data Processing Layer                        │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐   │
-│  │ Data         │  │ Cache        │  │ State            │   │
-│  │ Transformer  │  │ Manager      │  │ Manager          │   │
-│  └──────────────┘  └──────────────┘  └──────────────────┘   │
-├─────────────────────────────────────────────────────────────┤
-│                 Integration Layer                            │
-│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐   │
-│  │ Power BI     │  │ Data         │  │ Export/Import    │   │
-│  │ Connector    │  │ Connector    │  │ Manager          │   │
-│  └──────────────┘  └──────────────┘  └──────────────────┘   │
-└─────────────────────────────────────────────────────────────┘
++-------------------------------------------------------------+
+|                   User Interface Layer                       |
+|  +--------------+  +--------------+  +------------------+   |
+|  | Configuration|  | Visualization|  | Interaction      |   |
+|  | Panels       |  | Canvas       |  | Controls         |   |
+|  +--------------+  +--------------+  +------------------+   |
++-------------------------------------------------------------+
+|                 Business Logic Layer                         |
+|  +--------------+  +--------------+  +------------------+   |
+|  | Calculation  |  | Formatting   |  | Event            |   |
+|  | Engine       |  | Engine       |  | Handler          |   |
+|  +--------------+  +--------------+  +------------------+   |
++-------------------------------------------------------------+
+|                 Data Processing Layer                        |
+|  +--------------+  +--------------+  +------------------+   |
+|  | Data         |  | Cache        |  | State            |   |
+|  | Transformer  |  | Manager      |  | Manager          |   |
+|  +--------------+  +--------------+  +------------------+   |
++-------------------------------------------------------------+
+|                 Integration Layer                            |
+|  +--------------+  +--------------+  +------------------+   |
+|  | Power BI     |  | Connector    |  | Export/Import    |   |
+|  | Connector    |  | Connector    |  | Manager          |   |
+|  +--------------+  +--------------+  +------------------+   |
++-------------------------------------------------------------+
 ```
 
 These layers work together to provide a comprehensive analytics experience while maintaining compatibility with the Power BI environment.

diff --git a/chapters/060_chapter2_installation_licensing_options.md b/chapters/060_chapter2_installation_licensing_options.md
@@ -13,12 +13,12 @@ The simplest and most common installation method is through Microsoft AppSource:
 1. **Navigate to AppSource**: Visit the Microsoft AppSource marketplace (appsource.microsoft.com)
 2. **Search for Inforiver**: Enter "Inforiver" in the search bar
 3. **Select Analytics+**: Choose the Inforiver Analytics+ visual from the search results
-   ![Analytics](https://github.com/user-attachments/assets/9bd53f21-8288-4f35-9267-a7bce9744f70)
+   ![Analytics](images/power-bi-visuals-inforiver-analytics-reporting-writeback.png)
 5. **Get It Now**: Click the "Get it now" button to initiate the installation
 6. **Authentication**: Sign in with your Microsoft account if prompted
 7. **Confirm Installation**: Approve the installation in your Power BI organization
 8. **Verification**: Confirm the visual appears in your Power BI Desktop visualization pane
-![Verification](https://github.com/user-attachments/assets/7b8f862d-6a14-415b-a473-3e173ba9a3eb)
+![Verification](images/visualization-tools-data-fields-drill-through-options.png)
 
 This method ensures you receive the official, certified version of Inforiver Analytics+ and simplifies the update process through AppSource's update mechanisms.
 
@@ -30,12 +30,12 @@ For organizations with specific deployment requirements, direct import in Power
 2. **Open Power BI Desktop**: Launch your local Power BI Desktop application
 3. **Import Custom Visual**: Click the "..." in the Visualizations pane
 
-   ![Custom Visual](https://github.com/user-attachments/assets/481abd66-28c9-4757-a1d1-0639d1a6034a)
+   ![Custom Visual](images/import-visual-from-file-menu-options.png)
 5. **Select "Import from file"**: Browse to the downloaded .pbiviz file
 6. **Confirm Import**: Approve any security prompts that appear
 7. **Verify Installation**: Check that the Inforiver icon appears in your visualization pane
 
-   ![Installation](https://github.com/user-attachments/assets/15fc179e-1180-4b85-8079-dc98c986e8a2)
+   ![Installation](images/visualization-tools-data-fields-drill-through-options.png)
 
 This method is useful for controlled environments where AppSource access may be restricted or for testing specific versions before organizational deployment.
 

diff --git a/chapters/070_chapter2_first_steps_with_analytics_plus.md b/chapters/070_chapter2_first_steps_with_analytics_plus.md
@@ -13,7 +13,7 @@ The first step in using Inforiver Analytics+ is to add it to your Power BI repor
 5. **Add to Canvas**: Click on the Inforiver Analytics+ icon to add it to your report canvas
 6. **Resize Visual**: Adjust the size and position of the visual on your canvas
 
-![Useful Links](https://github.com/user-attachments/assets/69483d35-f618-4190-8be0-d8ce12168736)
+![Useful Links](images/infoviewer-analytics-visualization-software-interface.png)
 
 Use the links in the visual for additional information:
 
@@ -26,7 +26,7 @@ Use the links in the visual for additional information:
 
 The Analytics+ visual ships with different modes - chart, card, table, and Gantt. Each mode has a dedicated toolbar that contains customization options specific to it. 
 
-![Selection](https://github.com/user-attachments/assets/2223e6dc-9bed-4d69-bf19-d6f1a2d4c67d)
+![Selection](images/infoview-analytics-charts-cards-tables-interface.png)
 
 
 ## Assign Data
@@ -38,27 +38,27 @@ For starters, you can assign the Axis and Values visual parameters. We've added
 |          |
 |:--------:|
 | **Chart mode** |
-| ![Chart Mode](https://github.com/user-attachments/assets/40ec8644-6abc-400f-8592-ec7a7f2544a6) |
+| ![Chart Mode](images/2022-actuals-by-sub-region-bar-chart.png) |
 
 
 |          |
 |:--------:|
 | **Card mode** |
-| ![Card Mode](https://github.com/user-attachments/assets/dc73c627-76f2-4283-a4a8-4510a4cc1077) | 
+| ![Card Mode](images/data-visualization-kpi-card-chart-elements.png) | 
 
 
 
 |          |
 |:--------:|
 | **Table mode** |
-| ![Table Mode](https://github.com/user-attachments/assets/52890a84-d100-4659-9b11-e81395515fd2) |  
+| ![Table Mode](images/2023-actuals-by-subcategory-data-table.png) |  
 
 
 
 |          |
 |:--------:|
 | **Gantt mode** |
-| ![Gantt Mode](https://github.com/user-attachments/assets/9d454400-18bf-4b16-a1d2-5b27187c4f1a) |   
+| ![Gantt Mode](images/gantt-chart-employee-project-schedule-2024-2025-1.png) |   
 
 
 By following these first steps and guidance, you'll quickly become comfortable with Inforiver Analytics+ and begin creating powerful, insightful visualizations that exceed the capabilities of native Power BI visuals.

diff --git a/chapters/080_chapter2_interface_overview_navigation_principles.md b/chapters/080_chapter2_interface_overview_navigation_principles.md
@@ -7,16 +7,16 @@ Inforiver Analytics+ features a sophisticated yet intuitive interface designed t
 The Inforiver Analytics+ interface consists of several key components organized in a logical structure:
 
 ```
-┌───────────────────────────────────────────────────────────────┐
-│ Toolbar and Global Controls                                   │
-├───────────┬───────────────────────────────────┬───────────────┤
-│           │                                   │               │
-│ Field     │                                   │ Configuration │
-│ Selection │         Visualization Area        │     Panel     │
-│ Panel     │                                   │               │
-├───────────┴───────────────────────────────────┴───────────────┤
-│ Status Bar / Information Area                                 │
-└───────────────────────────────────────────────────────────────┘
++---------------------------------------------------------------+
+| Toolbar and Global Controls                                   |
++-----------+-----------------------------------+---------------+
+|           |                                   |               |
+| Field     |                                   | Configuration |
+| Selection |         Visualization Area        |     Panel     |
+| Panel     |                                   |               |
++-----------+-----------------------------------+---------------+
+| Status Bar / Information Area                                 |
++---------------------------------------------------------------+
 ```
 
 This layout is designed to provide easy access to all necessary tools while maximizing the space available for your visualization.