galaaz 2.1.8 → 2.1.9

data/blogs/manual/manual.Rmd

@@ -10,11 +10,16 @@ output:
     self_contained: true
     keep_md: true
     toc: true
+    toc_float: true
     toc_depth: 3
     number_sections: true
+    includes:
+      before_body: _logo_before_body.html
   pdf_document:
     includes:
-      in_header: "../../sty/galaaz.sty"
+      in_header:
+        - "../../sty/galaaz.sty"
+        - "../../sty/galaaz-headers-from-p3.tex"
     keep_tex: yes
     number_sections: yes
     toc: true
@@ -34,6 +39,11 @@ R.options(crayon__enabled: false, width: 70)
 R.install_and_loads('kableExtra')
 ```
 
+```{r brand_logo, echo=FALSE, fig.align='center', out.width='45%', eval=knitr::is_latex_output()}
+# PDF only — HTML uses _logo_before_body.html (above the TOC).
+knitr::include_graphics("images/galaaz-lockup-stacked.png")
+```
+
 # Introduction
 
 Galaaz is a system for tightly coupling Ruby and R. Ruby is a powerful language, with a large 
@@ -208,7 +218,9 @@ df_gk <- data.frame(
 bin_tbl(df_gk)
 ```
 
-**`gknit` CLI** (see `gknit -h`): `--output_format`, `--output_file`, `--output_dir`, `--bridge_timeout_sec`, `--callback_timeout_ms`. If `--output_format` is omitted, the **first** YAML `output:` target wins.
+**`gknit` CLI** (see `gknit -h`): `--output_format`, `--output_file`,
+`--output_dir`, `--bridge_timeout_sec`, `--callback_timeout_ms`.
+If `--output_format` is omitted, the **first** YAML `output:` target wins.
 
 Prefer **`galaaz-jruby`** for **`gknit-draft`** workflows until that wrapper matches the **`gknit`** stack.
 
@@ -295,7 +307,8 @@ A **table of all `bin/` scripts** (bootstrap, Ruby launcher, gstudio, gknit, tes
 
 1. Install **bundler** if needed, then run **`bundle install`** with your chosen Ruby
    (`jruby -S bundle install` or CRuby `bundle install`) in the repository root.
-2. Build the bridge native code: **`make -C ext/new_bridge all`** (or **`rake compile_gatekeeper`**).
+2. Build the bridge native code: **`make -C ext/new_bridge all`**
+   (or **`rake compile_gatekeeper`**).
 3. Run scripts with **`bin/galaaz-ruby`** (uses `ruby` on `PATH`; set **`GALAAZ_RUBY=jruby`** or
    **`GALAAZ_RUBY=ruby`** to force an engine). Spec runners: **`bin/run_rspec`** /
    **`bin/run_all_rspec`** (same `GALAAZ_RUBY` rule). **`bin/galaaz-jruby`** remains a thin
@@ -422,8 +435,9 @@ For R work that can take a long time **on the bridge**, the bridge can avoid a R
   **`R.<rname>`**. Optional keyword **`timeout:`** applies a Ruby-side wait limit (completion receives
   **`NewBridge::SessionClient::TimeoutError`** if R is too slow).
 
-**Important:** **`R.foo(...) { |x| }`** is already used for dplyr-style scopes (`R::Support.new_scope`),
-so async R calls must use **`R::Async`** or **`R.eval_r_async`**, not a bare **`R.foo` with a block.**
+**Important:** **`R.foo(...) { |x| }`** is already used for dplyr-style
+scopes (`R::Support.new_scope`), so async R calls must use **`R::Async`**
+or **`R.eval_r_async`**, not a bare **`R.foo` with a block.**
 
 `NewBridge::EvalResult` exposes **`#ok?`**, **`#value`**, and **`#error`**. The completion block runs on a
 **background thread** (not the bridge reader thread).
@@ -1473,7 +1487,12 @@ the first with a message explaining what went wrong and the second with the full
 of the error.
 
 ```{ruby r_exception}
-vec = R.c(1, hello, 5)
+begin
+  vec = R.c(1, hello, 5)
+rescue => e
+  puts e.class.to_s
+  e.message.to_s.scan(/.{1,68}/).each { |line| puts line }
+end
 ```
 
 Here is a vector with logical values
@@ -2211,11 +2230,13 @@ else
 end
 ```
 
-**What to notice:** (1) Ruby only sees **`Hash`** rows and Ruby **`Thread`** objects; (2) a single
-**`from_ruby_batches`** call creates the Arrow table in R; (3) **`dplyr___group_by`** /
-**`dplyr___summarise`** / **`dplyr___collect`** mirror **`dplyr::group_by`** /
-**`dplyr::summarise`** / **`dplyr::collect`** on an Arrow-backed table. For a lighter test, see
-**`specs/arrow_from_ruby_batches_spec.rb`**; for the full-size benchmark, run
+**What to notice:** (1) Ruby only sees **`Hash`** rows and Ruby **`Thread`** objects;
+(2) a single **`from_ruby_batches`** call creates the Arrow table in R;
+(3) **`dplyr___group_by`** / **`dplyr___summarise`** / **`dplyr___collect`**
+mirror **`dplyr::group_by`** / **`dplyr::summarise`** / **`dplyr::collect`**
+on an Arrow-backed table. For a lighter test, see
+**`specs/arrow_from_ruby_batches_spec.rb`**;
+for the full-size benchmark, run
 **`bin/run_slow_rspec slow-specs/arrow_large_pipeline_spec.rb`**.
 
 # Bioconductor and DESeq2

data/blogs/manual/manual.md

@@ -10,11 +10,16 @@ output:
     self_contained: true
     keep_md: true
     toc: true
+    toc_float: true
     toc_depth: 3
     number_sections: true
+    includes:
+      before_body: _logo_before_body.html
   pdf_document:
     includes:
-      in_header: "../../sty/galaaz.sty"
+      in_header:
+        - "../../sty/galaaz.sty"
+        - "../../sty/galaaz-headers-from-p3.tex"
     keep_tex: yes
     number_sections: yes
     toc: true
@@ -26,6 +31,8 @@ fontsize: 11pt
 
 
 
+
+
 # Introduction
 
 Galaaz is a system for tightly coupling Ruby and R. Ruby is a powerful language, with a large 
@@ -226,7 +233,9 @@ bin/galaaz-jruby -S rspec
 </tbody>
 </table>
 
-**`gknit` CLI** (see `gknit -h`): `--output_format`, `--output_file`, `--output_dir`, `--bridge_timeout_sec`, `--callback_timeout_ms`. If `--output_format` is omitted, the **first** YAML `output:` target wins.
+**`gknit` CLI** (see `gknit -h`): `--output_format`, `--output_file`,
+`--output_dir`, `--bridge_timeout_sec`, `--callback_timeout_ms`.
+If `--output_format` is omitted, the **first** YAML `output:` target wins.
 
 Prefer **`galaaz-jruby`** for **`gknit-draft`** workflows until that wrapper matches the **`gknit`** stack.
 
@@ -341,7 +350,8 @@ A **table of all `bin/` scripts** (bootstrap, Ruby launcher, gstudio, gknit, tes
 
 1. Install **bundler** if needed, then run **`bundle install`** with your chosen Ruby
    (`jruby -S bundle install` or CRuby `bundle install`) in the repository root.
-2. Build the bridge native code: **`make -C ext/new_bridge all`** (or **`rake compile_gatekeeper`**).
+2. Build the bridge native code: **`make -C ext/new_bridge all`**
+   (or **`rake compile_gatekeeper`**).
 3. Run scripts with **`bin/galaaz-ruby`** (uses `ruby` on `PATH`; set **`GALAAZ_RUBY=jruby`** or
    **`GALAAZ_RUBY=ruby`** to force an engine). Spec runners: **`bin/run_rspec`** /
    **`bin/run_all_rspec`** (same `GALAAZ_RUBY` rule). **`bin/galaaz-jruby`** remains a thin
@@ -494,8 +504,9 @@ For R work that can take a long time **on the bridge**, the bridge can avoid a R
   **`R.<rname>`**. Optional keyword **`timeout:`** applies a Ruby-side wait limit (completion receives
   **`NewBridge::SessionClient::TimeoutError`** if R is too slow).
 
-**Important:** **`R.foo(...) { |x| }`** is already used for dplyr-style scopes (`R::Support.new_scope`),
-so async R calls must use **`R::Async`** or **`R.eval_r_async`**, not a bare **`R.foo` with a block.**
+**Important:** **`R.foo(...) { |x| }`** is already used for dplyr-style
+scopes (`R::Support.new_scope`), so async R calls must use **`R::Async`**
+or **`R.eval_r_async`**, not a bare **`R.foo` with a block.**
 
 `NewBridge::EvalResult` exposes **`#ok?`**, **`#value`**, and **`#error`**. The completion block runs on a
 **background thread** (not the bridge reader thread).
@@ -2859,25 +2870,19 @@ of the error.
 
 
 ``` ruby
-vec = R.c(1, hello, 5)
+begin
+  vec = R.c(1, hello, 5)
+rescue => e
+  puts e.class.to_s
+  e.message.to_s.scan(/.{1,68}/).each { |line| puts line }
+end
 ```
 
 ```
+## NameError
 ## undefined local variable or method 'hello' for an instance of RC
 ```
 
-```
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:170:in 'exec_ruby'
-## org/jruby/RubyKernel.java:1459:in 'eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:169:in 'exec_ruby'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:777:in 'block in initialize'
-## org/jruby/RubyBasicObject.java:2713:in 'instance_eval'
-## org/jruby/RubyBasicObject.java:2741:in 'instance_eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:748:in 'block in initialize'
-## /home/rbotafogo/desenv_linux/galaaz/lib/R_interface/new_bridge_adapter.rb:371:in 'block in register_callback_proc_stub'
-## /home/rbotafogo/desenv_linux/galaaz/lib/new_bridge/session_client.rb:458:in 'block in handle_call'
-```
-
 Here is a vector with logical values
 
 
@@ -4302,11 +4307,13 @@ end
 ## Sum of group counts n (should equal 2000): 2000
 ```
 
-**What to notice:** (1) Ruby only sees **`Hash`** rows and Ruby **`Thread`** objects; (2) a single
-**`from_ruby_batches`** call creates the Arrow table in R; (3) **`dplyr___group_by`** /
-**`dplyr___summarise`** / **`dplyr___collect`** mirror **`dplyr::group_by`** /
-**`dplyr::summarise`** / **`dplyr::collect`** on an Arrow-backed table. For a lighter test, see
-**`specs/arrow_from_ruby_batches_spec.rb`**; for the full-size benchmark, run
+**What to notice:** (1) Ruby only sees **`Hash`** rows and Ruby **`Thread`** objects;
+(2) a single **`from_ruby_batches`** call creates the Arrow table in R;
+(3) **`dplyr___group_by`** / **`dplyr___summarise`** / **`dplyr___collect`**
+mirror **`dplyr::group_by`** / **`dplyr::summarise`** / **`dplyr::collect`**
+on an Arrow-backed table. For a lighter test, see
+**`specs/arrow_from_ruby_batches_spec.rb`**;
+for the full-size benchmark, run
 **`bin/run_slow_rspec slow-specs/arrow_large_pipeline_spec.rb`**.
 
 # Bioconductor and DESeq2

data/blogs/manual/manual.tex

@@ -145,7 +145,7 @@
 \usepackage[utf8]{inputenc}
 
 \usepackage{geometry}
-\geometry{a4paper, top=1in}
+\geometry{a4paper, top=1.05in, headheight=30pt, headsep=14pt}
 
 % needed for kableExtra
 \usepackage{longtable}
@@ -166,29 +166,60 @@
 \usepackage{graphicx}
 
 \usepackage{fancyhdr}
-% set the header and foot style
-% style 'fancy' adds the section name on the header
-% and the page number on the footer
+% Header: small Galaaz mark (left); page number + section title (right),
+% matching classic LaTeX style: "4  AN EXTENSION TO THE EXAMPLE"
+% (upright page number, uppercase italic section name).
+% Logo paths cover repo blogs (../../sty/), installed ~/sty/, and local images/.
+% Blogs may delay headers with \renewcommand{\galaazheaderfrompage}{3} after this sty
+% (e.g. skip title/TOC and a logo splash page).
+\newcommand{\galaazheaderfrompage}{1}
+\newcommand{\galaazheaderlogo}{%
+  \raisebox{-0.12\height}{%
+    \IfFileExists{../../sty/galaaz-header.png}{%
+      \includegraphics[height=0.32in]{../../sty/galaaz-header.png}%
+    }{%
+      \IfFileExists{galaaz-header.png}{%
+        \includegraphics[height=0.32in]{galaaz-header.png}%
+      }{%
+        \IfFileExists{images/galaaz-header.png}{%
+          \includegraphics[height=0.32in]{images/galaaz-header.png}%
+        }{}%
+      }%
+    }%
+  }%
+}
+% Section title only in marks (no \thesection); page number is separate.
+\renewcommand{\sectionmark}[1]{\markboth{#1}{}}
+\renewcommand{\subsectionmark}[1]{}% keep the current section in the header
+\newcommand{\galaazmaybeheaderlogo}{%
+  \ifnum\value{page}<\galaazheaderfrompage\relax\else\galaazheaderlogo\fi}
+\newcommand{\galaazmayberighthead}{%
+  \ifnum\value{page}<\galaazheaderfrompage\relax
+  \else
+    \textup{\thepage}\hspace{1em}\textit{\MakeUppercase{\leftmark}}%
+  \fi
+}
 \pagestyle{fancy}
-
-% style 'fancyhf' leaves header and footer empty
-%\fancyhf{}
-
-% sets the left head element to \rightmark, which contains the
-% current section (\leftmark is the current chapter)
-%\fancyhead[L]{\rightmark} .
-
-% sets the right head element to the page number.
-% \fancyhead[R]{\thepage}
-
-% lets the head rule disappear.
-% \renewcommand{\headrulewidth}{0pt}
-% Possible selectors for the optional argument of \fancyhead/\fancyfoot
-% are L (left), C (center) or R (right) for the position of the element
-% and E (even) or O (odd) to distinguish even and odd pages. If you omit
-% E/O the element is set for all pages.
-
-% \usepackage{lipsum}
+\fancyhf{}
+\fancyhead[L]{\galaazmaybeheaderlogo}
+\fancyhead[R]{\galaazmayberighthead}
+\renewcommand{\headrulewidth}{0.3pt}
+\makeatletter
+\renewcommand{\headrule}{%
+  \ifnum\value{page}<\galaazheaderfrompage\relax
+  \else
+    \hrule\@height\headrulewidth\@width\headwidth
+    \vskip-\headrulewidth
+  \fi
+}
+\makeatother
+% First page often uses plain; same conditional header logic.
+\fancypagestyle{plain}{%
+  \fancyhf{}%
+  \fancyhead[L]{\galaazmaybeheaderlogo}%
+  \fancyhead[R]{\galaazmayberighthead}%
+  \renewcommand{\headrulewidth}{0.3pt}%
+}
 
 % make available command lastpage
 \usepackage{lastpage}
@@ -233,6 +264,10 @@
 
 % 
 %\newcommand{\atraso}[1]{\color{red} \textbf {Tempo desde a Assinatura do Contrato: #1 dias}}
+% No header on title/TOC (p.1) or splash logo page (p.2);
+% logo + page number + section title from page 3 onward.
+% Load after galaaz.sty.
+\renewcommand{\galaazheaderfrompage}{3}
 \usepackage{booktabs}
 \usepackage{longtable}
 \usepackage{array}
@@ -274,6 +309,8 @@
 \setcounter{tocdepth}{3}
 \tableofcontents
 }
+\begin{center}\includegraphics[width=0.45\linewidth]{images/galaaz-lockup-stacked} \end{center}
+
 \section{Introduction}\label{introduction}
 
 Galaaz is a system for tightly coupling Ruby and R. Ruby is a powerful
@@ -607,8 +644,9 @@ gatekeeper}. You do not need a git clone.
   Compile the native gatekeeper from the installed gem:
 
 \begin{verbatim}
-gem_dir="$(ruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path")"
-# under JRuby: gem_dir="$(jruby -e "puts Gem::Specification.find_by_name('galaaz').full_gem_path")"
+gem_dir="$(ruby -e \
+  "puts Gem::Specification.find_by_name('galaaz').full_gem_path")"
+# under JRuby: use jruby -e instead of ruby -e
 make -C "${gem_dir}/ext/new_bridge" all
 \end{verbatim}
 \item
@@ -990,37 +1028,21 @@ methods still await by default and return the \texttt{Job}.
 
 \begin{Shaded}
 \begin{Highlighting}[]
-\NormalTok{coef }\OperatorTok{=} \ConstantTok{R}\OperatorTok{::}\DataTypeTok{Job}\AttributeTok{.eval}\NormalTok{(}\OperatorTok{\textless{}\textless{}\textasciitilde{}}\ControlFlowTok{R}\DocumentationTok{) \{ |job| job.load\_rds \}}
-\DocumentationTok{  fit \textless{}{-} lm(mpg \textasciitilde{} wt, data = mtcars)}
-\DocumentationTok{  saveRDS(unname(coef(fit)), result\_path)}
-\ControlFlowTok{R}
-\FunctionTok{puts}\NormalTok{ coef}
+\ControlFlowTok{begin}
+\NormalTok{  coef }\OperatorTok{=} \ConstantTok{R}\OperatorTok{::}\DataTypeTok{Job}\AttributeTok{.eval}\NormalTok{(}\OperatorTok{\textless{}\textless{}\textasciitilde{}}\ControlFlowTok{R}\DocumentationTok{) \{ |job| job.load\_rds \}}
+\DocumentationTok{    fit \textless{}{-} lm(mpg \textasciitilde{} wt, data = mtcars)}
+\DocumentationTok{    saveRDS(unname(coef(fit)), result\_path)}
+\DocumentationTok{  }\ControlFlowTok{R}
+  \FunctionTok{puts}\NormalTok{ coef}
+\ControlFlowTok{rescue} \OperatorTok{=\textgreater{}}\NormalTok{ e}
+  \FunctionTok{puts}\NormalTok{ e}\AttributeTok{.class.to\_s}
+\NormalTok{  e}\AttributeTok{.message.to\_s.scan}\NormalTok{(}\SpecialStringTok{/.\{1,68\}/}\NormalTok{)}\AttributeTok{.each} \OperatorTok{\{} \OperatorTok{|}\NormalTok{line}\OperatorTok{|} \FunctionTok{puts}\NormalTok{ line }\OperatorTok{\}}
+\ControlFlowTok{end}
 \end{Highlighting}
 \end{Shaded}
 
 \begin{verbatim}
-## Permission denied - /home/rbotafogo/.local/share/galaaz/jobs/eval-20260908T145009-4153-db9080
-\end{verbatim}
-
-\begin{verbatim}
-## org/jruby/RubyDir.java:693:in 'mkdir'
-## /home/rbotafogo/.asdf/installs/ruby/jruby-10.1.1.0/lib/ruby/stdlib/fileutils.rb:403:in 'fu_mkdir'
-## /home/rbotafogo/.asdf/installs/ruby/jruby-10.1.1.0/lib/ruby/stdlib/fileutils.rb:381:in 'block in mkdir_p'
-## org/jruby/RubyArrayNative.java:1807:in 'reverse_each'
-## /home/rbotafogo/.asdf/installs/ruby/jruby-10.1.1.0/lib/ruby/stdlib/fileutils.rb:379:in 'block in mkdir_p'
-## org/jruby/RubyArrayNative.java:1729:in 'each'
-## /home/rbotafogo/.asdf/installs/ruby/jruby-10.1.1.0/lib/ruby/stdlib/fileutils.rb:371:in 'mkdir_p'
-## /home/rbotafogo/desenv_linux/galaaz/lib/R_interface/r_job.rb:140:in 'initialize'
-## /home/rbotafogo/desenv_linux/galaaz/lib/R_interface/r_job.rb:94:in 'eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:170:in 'exec_ruby'
-## org/jruby/RubyKernel.java:1459:in 'eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:169:in 'exec_ruby'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:777:in 'block in initialize'
-## org/jruby/RubyBasicObject.java:2713:in 'instance_eval'
-## org/jruby/RubyBasicObject.java:2741:in 'instance_eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:748:in 'block in initialize'
-## /home/rbotafogo/desenv_linux/galaaz/lib/R_interface/new_bridge_adapter.rb:371:in 'block in register_callback_proc_stub'
-## /home/rbotafogo/desenv_linux/galaaz/lib/new_bridge/session_client.rb:458:in 'block in handle_call'
+## [1] 37.285126 -5.344472
 \end{verbatim}
 
 \begin{Shaded}
@@ -2707,26 +2729,20 @@ error.
 
 \begin{Shaded}
 \begin{Highlighting}[]
-\NormalTok{vec }\OperatorTok{=} \ConstantTok{R}\AttributeTok{.c}\NormalTok{(}\DecValTok{1}\NormalTok{, hello, }\DecValTok{5}\NormalTok{)}
+\ControlFlowTok{begin}
+\NormalTok{  vec }\OperatorTok{=} \ConstantTok{R}\AttributeTok{.c}\NormalTok{(}\DecValTok{1}\NormalTok{, hello, }\DecValTok{5}\NormalTok{)}
+\ControlFlowTok{rescue} \OperatorTok{=\textgreater{}}\NormalTok{ e}
+  \FunctionTok{puts}\NormalTok{ e}\AttributeTok{.class.to\_s}
+\NormalTok{  e}\AttributeTok{.message.to\_s.scan}\NormalTok{(}\SpecialStringTok{/.\{1,68\}/}\NormalTok{)}\AttributeTok{.each} \OperatorTok{\{} \OperatorTok{|}\NormalTok{line}\OperatorTok{|} \FunctionTok{puts}\NormalTok{ line }\OperatorTok{\}}
+\ControlFlowTok{end}
 \end{Highlighting}
 \end{Shaded}
 
 \begin{verbatim}
+## NameError
 ## undefined local variable or method 'hello' for an instance of RC
 \end{verbatim}
 
-\begin{verbatim}
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:170:in 'exec_ruby'
-## org/jruby/RubyKernel.java:1459:in 'eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/util/exec_ruby.rb:169:in 'exec_ruby'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:777:in 'block in initialize'
-## org/jruby/RubyBasicObject.java:2713:in 'instance_eval'
-## org/jruby/RubyBasicObject.java:2741:in 'instance_eval'
-## /home/rbotafogo/desenv_linux/galaaz/lib/gknit/knitr_engine.rb:748:in 'block in initialize'
-## /home/rbotafogo/desenv_linux/galaaz/lib/R_interface/new_bridge_adapter.rb:371:in 'block in register_callback_proc_stub'
-## /home/rbotafogo/desenv_linux/galaaz/lib/new_bridge/session_client.rb:458:in 'block in handle_call'
-\end{verbatim}
-
 Here is a vector with logical values
 
 \begin{Shaded}
@@ -4766,11 +4782,17 @@ definition of `mutate\_y' above:
 \begin{Shaded}
 \begin{Highlighting}[]
 \NormalTok{a }\OperatorTok{=} \DecValTok{10}
-\NormalTok{mutate\_y(df1)}
+\ControlFlowTok{begin}
+\NormalTok{  mutate\_y(df1)}
+\ControlFlowTok{rescue} \OperatorTok{=\textgreater{}}\NormalTok{ e}
+  \FunctionTok{puts}\NormalTok{ e}\AttributeTok{.class.to\_s}
+\NormalTok{  e}\AttributeTok{.message.to\_s.scan}\NormalTok{(}\SpecialStringTok{/.\{1,68\}/}\NormalTok{)}\AttributeTok{.each} \OperatorTok{\{} \OperatorTok{|}\NormalTok{line}\OperatorTok{|} \FunctionTok{puts}\NormalTok{ line }\OperatorTok{\}}
+\ControlFlowTok{end}
 \end{Highlighting}
 \end{Shaded}
 
 \begin{verbatim}
+## NewBridge::SessionClient::RProcessError
 ## Error: i In argument: `y = a + x`.
 ## Caused by error:
 ## ! object 'a' not found

data/blogs/nse_dplyr/nse_dplyr.Rmd

@@ -9,9 +9,17 @@ output:
   html_document:
     self_contained: true
     keep_md: true
+    toc: true
+    toc_float: true
+    toc_depth: 2
+    number_sections: true
+    includes:
+      before_body: _logo_before_body.html
   pdf_document:
     includes:
-      in_header: ["../../sty/galaaz.sty"]
+      in_header:
+        - "../../sty/galaaz.sty"
+        - "../../sty/galaaz-headers-from-p3.tex"
     keep_tex: yes
     number_sections: yes
     toc: true
@@ -29,6 +37,11 @@ library('dplyr')
 library('tibble')
 ```
 
+```{r brand_logo, echo=FALSE, fig.align='center', out.width='45%', eval=knitr::is_latex_output()}
+# PDF only — HTML uses _logo_before_body.html (above the TOC).
+knitr::include_graphics("images/galaaz-lockup-stacked.png")
+```
+
 # Introduction
 
 According to Steven Sagaert’s answer on Quora about “Is programming language R overrated?”: