docs: explain formats

.gitignore

@@ -1,24 +0,0 @@
-# macOS
-.DS_Store
-
-# Build outputs
-*.pdf
-*.xdv
-
-# LaTeX auxiliary files
-*.aux
-*.bbl
-*.bcf
-*.bcf-SAVE-ERROR
-*.blg
-*.fdb_latexmk
-*.fls
-*.log
-*.nav
-*.out
-*.run.xml
-*.snm
-*.toc
-
-# latexmk / biber temporary variants
-*.bbl-SAVE-ERROR

README.md

@@ -0,0 +1,40 @@
+# Bokeron template
+
+Este repositorio contiene las plantillas en distintos formatos para elaborar diapositivas destinadas a talleres y eventos de Open Bokeron.
+
+## Formatos disponibles
+
+### LaTeX
+
+**Cómo usar**
+
+1. Copiar a la raiz de tu proyecto:
+   - `main.tex`
+   - `beamerthemeBokeronTemp.sty`
+   - `images/`
+   - `background/`
+2. Opcionalmente, copiar `sections/` y crear ahí las secciones de tus diapositivas.
+3. Editar los `\input` en `main.tex` para que incluyan tus propias secciones. Alternativamente, eliminar los `\input` y editar directamente el contenido del `main.tex`.
+
+### Typst
+
+**Cómo usar**
+
+1. Copiar a la raiz de tu proyecto:
+   - `openbokeron.typ`
+2. Crear un fichero principal (por ejemplo `main.typ`) y añadir la siguiente cabecera:
+
+    ```typst
+    #import "openbokeron.typ": OpenBokeron
+    #show: OpenBokeron.with(
+    title: "Mi título",
+    subtitle: "Mi subtítulo (opcional)",
+    authors: (
+        (name: "Autor1", email: "example@example.com (opcional)"),
+    ),
+    //cover-image: image("mi_portada.png") // opcional
+    //cover-theme: "dark" // si mi portada requiere texto claro 
+    )
+
+    ```
+3. Editar con normalidad el resto del documento.

beamerthemeBokeronTemp.sty

@@ -1,13 +1,10 @@
-% Bokeron Template based on Bayes Business School Beamer theme by Emilio Luis Saenz Guillen
+% Bokeron Template based on Bayes Business School Beamer theme by Emilio Luis Sáenz Guillén
 
 \ProvidesPackage{beamerthemeBokeronTemp}
 
 \RequirePackage{silence}
 \WarningsOff[mathdesign/mdbch]
 \RequirePackage{etoolbox}
-\RequirePackage{fontawesome5}
-\RequirePackage{tikz}
-\RequirePackage{graphicx}
 
 % Eliminate navigation symbols
 \setbeamertemplate{navigation symbols}{}
@@ -15,14 +12,15 @@
 % Section and subsection numbering in table of contents
 \setbeamertemplate{section in toc}[sections numbered]
 \setbeamertemplate{subsection in toc}[subsections numbered]
-\useoutertheme[subsection=false]{miniframes}
+% Current position in the presentation
-\setbeamercolor{section in head/foot}{bg=BokeronBlue,fg=white}
+\useoutertheme[subsection = false]{miniframes}
+\setbeamercolor{section in head/foot}{bg=BokeronBlue, fg=white}
 
 % Captions numbering
 \setbeamertemplate{caption}[numbered]
 
 % Set slide margins
-\setbeamersize{text margin left=2.2em, text margin right=2.8em}
+\setbeamersize{text margin left=2em, text margin right=10em}
 
 % Set Normal Text Color
 \setbeamercolor{normal text}{fg=Black}
@@ -30,158 +28,85 @@
 % Structure colour (bullet points and section headings...)
 \setbeamercolor{structure}{fg=BokeronBlue}
 
+% Font
+\RequirePackage{fontspec}
+\setromanfont{Arial}
+\setsansfont[Scale=MatchLowercase]{Open Sans}
+\RequirePackage{tikz}
+% Font substitution
+\DeclareFontFamilySubstitution{TS1}{\sfdefault}{lmr}
+\DeclareFontFamilySubstitution{OMS}{\sfdefault}{lmr}
+
 % Define colours
-\definecolor{BokeronTitleBlue}{RGB}{0,149,197}
+\definecolor{BokeronTitleBlue}{RGB}{0, 149, 197}
 \definecolor{LighterBokeronTitleBlue}{RGB}{204,217,236}
-\definecolor{BokeronBlue}{RGB}{30,160,186}
+\definecolor{BokeronBlue}{RGB}{30, 160, 186}
-\definecolor{BoxLightBlue}{RGB}{173,235,255}
+\definecolor{BoxLightBlue}{RGB}{173, 235, 255}
-\definecolor{BokeronInk}{RGB}{17,53,71}
-\definecolor{BokeronMist}{RGB}{239,249,252}
 
-\newcommand{\BokeronCornerShapes}{%
-  \fill[BokeronBlue] ([xshift=-2.1cm]current page.north east) rectangle ([yshift=-1.4cm]current page.north east);
-  \fill[BokeronBlue] ([xshift=-1.1cm,yshift=-1.3cm]current page.north east) rectangle ([xshift=0cm,yshift=-2.4cm]current page.north east);
-}
-
-\newcommand{\BokeronLogoBadge}{%
-  \IfFileExists{images/LogoOpenBokeron.png}{%
-    \node[anchor=south east,inner sep=0pt] at ([xshift=-0.6cm,yshift=0.55cm]current page.south east) {\includegraphics[width=2.15cm]{images/LogoOpenBokeron.png}};
-  }{}
-}
-
-\newcommand{\BokeronStandardBackground}{%
-  \begin{tikzpicture}[remember picture,overlay]
-    \fill[white] (current page.south west) rectangle (current page.north east);
-    \BokeronCornerShapes
-    \draw[BokeronMist,line width=1pt] ([xshift=2.2cm,yshift=0.95cm]current page.south west) -- ([xshift=-2.8cm,yshift=0.95cm]current page.south east);
-  \end{tikzpicture}%
-}
-
-\newcommand{\BokeronSectionBackground}{%
-  \begin{tikzpicture}[remember picture,overlay]
-    \fill[white] (current page.south west) rectangle (current page.north east);
-    \BokeronCornerShapes
-    \BokeronLogoBadge
-    \draw[BokeronMist,line width=1pt] ([xshift=2.2cm,yshift=0.95cm]current page.south west) -- ([xshift=-3.3cm,yshift=0.95cm]current page.south east);
-  \end{tikzpicture}%
-}
-
-\newcommand{\BokeronTitleBackground}{%
-  \begin{tikzpicture}[remember picture,overlay]
-    \fill[black] (current page.south west) rectangle (current page.north east);
-    \ifx\inserttitlegraphic\@empty
-      \fill[BokeronMist] ([xshift=-7.1cm]current page.north east) rectangle (current page.south east);
-    \else
-      \node[anchor=north east,inner sep=0pt] at (current page.north east) {\includegraphics[width=0.56\paperwidth,height=\paperheight]{\inserttitlegraphic}};
-    \fi
-  \end{tikzpicture}%
-}
-
-\newcommand{\BokeronClosingBackground}{%
-  \begin{tikzpicture}[remember picture,overlay]
-    \fill[BokeronBlue] (current page.south west) rectangle (current page.north east);
-  \end{tikzpicture}%
-}
-
-\newcommand{\insertclosingqrgraphic}{}
-\newcommand{\closingqrgraphic}[1]{\renewcommand{\insertclosingqrgraphic}{#1}}
-\newcommand{\BokeronContactItem}[3]{%
-  {\Large\color{white}#1}\hspace{0.45em}{\large\color{white}\textbf{#2}}\\[0.15em]
-  {\normalsize\color{BokeronMist}#3}
-}
-
-\newcommand{\BokeronFrameTitleLayout}[2]{%
-  \setbeamertemplate{frametitle}{%
-    \vspace*{#1}%
-    \noindent\begin{beamercolorbox}[wd=0.78\paperwidth,left]{frametitle}%
-      \usebeamerfont{frametitle}\insertframetitle
-    \end{beamercolorbox}%
-    \vspace*{#2}%
-  }
-}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%% TITLE %%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Adjust Frame Title Position
+\setbeamertemplate{frametitle}{\vskip-0.2\paperheight\insertframetitle} 
+% Frame Title Font
 \setbeamerfont{frametitle}{family=\rmfamily,series=\mdseries,size=\Large}
+% Set Color for Title-like Elements
 \setbeamercolor{titlelike}{fg=BokeronTitleBlue}
-\setbeamertemplate{title page}{%
+% Title page
-  \vbox{}
+\setbeamertemplate{title page}{
-  \vfill
+    \vbox{}
-  \begin{minipage}[t]{0.38\paperwidth}
+    \vfill   
-    {\usebeamerfont{title}\usebeamercolor[fg]{title}\inserttitle\par}
+    \hbox{  
-    \ifx\insertsubtitle\@empty\else
+        % Uncomment the following line if using Finsbury square or red background
-      \vspace{0.45em}
+        % \hspace{3.5in}
-      {\usebeamerfont{subtitle}\usebeamercolor[fg]{subtitle}\insertsubtitle\par}
+        \begin{minipage}[t]{0.4\textwidth}
-    \fi
+            {\usebeamerfont{title}\usebeamercolor[fg]{title}\inserttitle\par}
-    \vspace{1.1em}
+            \ifx\insertsubtitle\@empty\else
-    {\usebeamerfont{author}\usebeamercolor[fg]{author}\insertauthor\par}
+                {\usebeamerfont{subtitle}\usebeamercolor[fg]{subtitle}\insertsubtitle\par}
-    \vspace{0.65em}
+            \fi
-    {\usebeamerfont{institute}\usebeamercolor[fg]{institute}\insertinstitute\par}
+            \vspace{0.1in}
-    \vspace{0.35em}
+            {\usebeamerfont{author}\usebeamercolor[fg]{author}\insertauthor\par}
-    {\usebeamerfont{date}\usebeamercolor[fg]{date}\insertdate\par}
+            \vspace{0.1in}
-  \end{minipage}
+            {\usebeamerfont{institute}\usebeamercolor[fg]{institute}\insertinstitute\par}
-  \hspace*{0.18\paperwidth}
+            {\usebeamerfont{date}\usebeamercolor[fg]{date}\insertdate\par}
-  \vfill
+        \end{minipage}
+        \hfill
+    }
+    \vfill
 }
+% Sizes
 \setbeamerfont{title}{family=\rmfamily,size=\LARGE}
-\setbeamerfont{subtitle}{size=\large}
 \setbeamerfont{author}{size=\large}
 \setbeamerfont{institute}{size=\large}
-\setbeamerfont{date}{size=\normalsize}
+% Colours
 \setbeamercolor{title}{fg=white}
-\setbeamercolor{subtitle}{fg=BokeronMist}
+\setbeamercolor{subtitle}{fg=white}
 \setbeamercolor{author}{fg=white}
-\setbeamercolor{institute}{fg=BokeronMist}
+\setbeamercolor{institute}{fg=white}
-\setbeamercolor{date}{fg=BokeronBlue}
+\setbeamercolor{date}{fg=white}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%% BACKGROUND %%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\usebackgroundtemplate{\BokeronStandardBackground}
+\usebackgroundtemplate%
+{%
+\includegraphics[width=\paperwidth,height=\paperheight]{background/corners2.png}%
+}
+
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%% CLOSING SLIDE %%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\setbeamertemplate{endpage}{%
+\setbeamertemplate{endpage}{
-  \begin{frame}[plain]
+\begin{frame}[plain]
-    \BokeronClosingBackground
+\begin{tikzpicture}[remember picture, overlay]
-    \vspace*{0.9cm}
+    % Background image
-    \begin{center}
+    \node[at=(current page.center)] {
-      {\fontsize{28}{32}\selectfont\color{white}\textbf{Muchas gracias}}\\[0.35em]
+        \includegraphics[width=\paperwidth,height=\paperheight]{background/CoverPage_OpenBokeron.png}
-      {\Large\color{white}openbokeron.uma.es}\\[0.18em]
+    };
-      {\large\color{BokeronMist}openbokeron.uma.es/forum}
+\end{tikzpicture}
-    \end{center}
+\end{frame}
-    \vfill
-    \begin{columns}[T,totalwidth=\textwidth]
-      \begin{column}{0.31\textwidth}
-        \raggedright
-        \BokeronContactItem{\faTelegramPlane}{Telegram}{Comunidad}\\[0.8em]
-        \BokeronContactItem{\faTwitter}{Twitter}{@OpenBokeron}
-      \end{column}
-      \begin{column}{0.28\textwidth}
-        \centering
-        \ifdefempty{\insertclosingqrgraphic}{%
-          \begin{tikzpicture}
-            \fill[white] (0,0) rectangle (2.45,2.45);
-            \draw[BokeronTitleBlue,line width=1pt] (0.16,0.16) rectangle (2.29,2.29);
-            \node[text width=1.7cm,align=center,text=BokeronTitleBlue] at (1.225,1.225) {QR aquí};
-          \end{tikzpicture}
-        }{%
-          \includegraphics[width=0.64\linewidth]{\insertclosingqrgraphic}
-        }\\[0.4em]
-        {\small\color{BokeronMist}Telegram}
-      \end{column}
-      \begin{column}{0.31\textwidth}
-        \raggedleft
-        {\Large\color{white}\faGlobe\hspace{0.45em}\textbf{Web}}\\[0.15em]
-        {\normalsize\color{BokeronMist}openbokeron.uma.es}\\[0.8em]
-        {\Large\color{white}\faComments\hspace{0.45em}\textbf{Foro}}\\[0.15em]
-        {\normalsize\color{BokeronMist}openbokeron.uma.es/forum}
-      \end{column}
-    \end{columns}
-    \vspace*{0.7cm}
-  \end{frame}
 }
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -190,26 +115,32 @@
 \setbeamertemplate{itemize item}{\textbullet}
 \setbeamertemplate{itemize subitem}{--}
 \setbeamertemplate{itemize subsubitem}{\textbullet}
+% First-Level List Identations
 \setlength{\leftmargini}{1.25em}
+% Second-Level List Indentation
 \setlength{\leftmarginii}{1em}
+% Third-Level List Indentation
 \setlength{\leftmarginiii}{1em}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%% FRAME TITLES %%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Normal frame title
 \newcommand{\normalframetitle}{%
-  \BokeronFrameTitleLayout{1.1em}{0.6em}
+  \setbeamertemplate{frametitle}{\vskip0.2\paperheight\insertframetitle} 
   \setbeamerfont{frametitle}{size=\LARGE,series=\mdseries}
+  \setstretch{1}
 }
+% Small frame title
 \newcommand{\smallframetitle}{%
-  \BokeronFrameTitleLayout{0.9em}{0.45em}
+  \setbeamertemplate{frametitle}{\vskip0.05\paperheight\insertframetitle}
-  \setbeamerfont{frametitle}{size={\fontsize{18}{22}},series=\bfseries}
+  \setbeamerfont{frametitle}{size={\fontsize{11}{15}},series=\bfseries}
 }
-\newcommand{\smallerframetitle}{%
+% Smaller frame title
-  \BokeronFrameTitleLayout{0.75em}{0.35em}
+\newcommand{\smallerframetitle}{
-  \setbeamerfont{frametitle}{size={\fontsize{14}{18}},series=\bfseries}
+  \setbeamertemplate{frametitle}{\vskip0.025\paperheight\insertframetitle}
+  \setbeamerfont{frametitle}{size={\fontsize{8}{12}},series=\bfseries}
 }
-\normalframetitle
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%% TABLES %%%%%%%%%%%%%%%%%%%
@@ -230,21 +161,27 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%% FOOTLINE %%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\setbeamercolor{myfootlinecolor}{bg=white,fg=BokeronBlue}
 \setbeamertemplate{footline}{%
-  \begin{beamercolorbox}[wd=\paperwidth,ht=3.8ex,dp=1.3ex,leftskip=.45cm,rightskip=.45cm plus1fil]{myfootlinecolor}
+\vskip0.15\paperheight
+}
+\setbeamercolor{myfootlinecolor}{bg=white,fg=BokeronBlue}
+\setbeamertemplate{footline}
+{%
+  \begin{beamercolorbox}[colsep=1.5pt, ht=3.5ex, dp=1.125ex, leftskip=.3cm, rightskip=.3cm plus1fil]{myfootlinecolor}
     \leavevmode{\usebeamerfont{author in head/foot}\insertshortauthor}%
     \hfill
     {\usebeamerfont{institute in head/foot}\insertshortinstitute}%
-    \hfill
+    \hfill%    
     {\usebeamerfont{title in head/foot}\insertframenumber/\inserttotalframenumber}
-  \end{beamercolorbox}%
+  \end{beamercolorbox}
-}
+}  
+
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%% OTHERS %%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Disable warning on \author
 \pdfstringdefDisableCommands{%
   \def\\{}%
   \def\texttt#1{<#1>}%
-}
+}

main.tex

@@ -45,8 +45,6 @@
   \texttt{alguien@uma.es}}
 \institute[Open Bokeron]{Open Bokeron\\ https://openbokeron.uma.es}
 \date{DD/MM/YYY}
-\titlegraphic{images/LogoOpenBokeron.png}
-\closingqrgraphic{images/QR.png}
 
 
 \begin{document}
@@ -56,7 +54,12 @@
 %----------------------------------------------------------------------------------------
 
 {
-\usebackgroundtemplate{\BokeronTitleBackground}
+\usebackgroundtemplate{
+\begin{tikzpicture}[remember picture, overlay]
+        \node[at=(current page.center)] {            \includegraphics[width=\paperwidth,height=\paperheight,keepaspectratio]{background/OpenBokeronPresentation_Cover.jpg} % portada
+        };
+    \end{tikzpicture}
+}
 \begin{frame}[plain]
   \titlepage
 \end{frame}
@@ -65,25 +68,19 @@
 % Current section
 \AtBeginSection[ ]
 {
-{
-\usebackgroundtemplate{\BokeronSectionBackground}
 \begin{frame}{}
-    \tableofcontents[currentsection,currentsubsection,
+    \tableofcontents[currentsection,currentsubsection,     
     sectionstyle=show/shaded]
 \end{frame}
 }
-}
 % Current subsection
 \AtBeginSubsection[ ]
 {
-{
-\usebackgroundtemplate{\BokeronSectionBackground}
 \begin{frame}{}
-    \tableofcontents[currentsection,currentsubsection,
+    \tableofcontents[currentsection,currentsubsection,     
     sectionstyle=show/shaded]
 \end{frame}
 }
-}
 
 \smallframetitle
 
@@ -95,10 +92,8 @@
 \input{sections/OtherExamples}
 \input{sections/Conclusion}
 
-\begin{frame}[allowframebreaks]{Referencias}
+\frame[shrink=30] {\printbibliography}
-  \printbibliography
-\end{frame}
 
 \AtEndDocument{\usebeamertemplate{endpage}}
 
-\end{document}
+\end{document}