\documentclass[11pt]{article}
\usepackage{ideavault}
\author{Tomasz M. Czarkowski}
\title{Idea Vault}

\begin{document}
\maketitle

\section{Why}
\par Assume, You are writing something large. For example, like me, a TT RPG system.
\par Often You will find Yourself wanting to declare some concept (idea, if You indulge me) and later print it all over the place, without needing to copy and paste \textbf{it}
\par For really complicated projects, You may want to classify some ideas using tags, or make them depend on each other.
\par This is what the Idea Vault is used for.

\section{Dependencies}
\par Idea Vault requires some packages (most of them for styling the printed idea).
\begin{itemize}
\item \texttt{bookmark}
\item \texttt{xargs}
\item \texttt{luacode}
\item \texttt{xpatch}
\item \texttt{mdframed}
\item \texttt{needspace}
\end{itemize}

\section{Usage}
\par For idea creation there is \texttt{\textbackslash{}createIdea}, while for printing them there are a few more:
\begin{itemize}
\item \texttt{\textbackslash{}printIdea} -- prints one idea
\item \texttt{\textbackslash{}printAllWithPrefix} -- prints all ideas in given prefix
\item \texttt{\textbackslash{}printAllWithTag} -- prints all ideas in given prefix that have given tag
\end{itemize}

\subsection{\textbackslash{}createIdea}
\begin{verbatim}
\printIdea[prefix]{name}{content}[dependencies][tags][weight]
\end{verbatim}
\begin{itemize}
\item \texttt{prefix}: prefix to locate the idea in. By default, equals to \texttt{default}.
\item \texttt{name}: name of the idea. If such name exists in prefix, it will be overwritten
\item \texttt{content}: valid LaTeX code for the content of idea. It will be evaluated at invocation time.
\item \texttt{dependencies}: each dependency is Lua pair of strings, multiple dependencies are separated with comma.
\item \texttt{tags}: each tag is Lua string, multiple tags are separated with comma.
\item \texttt{weight}: a number used for sorting ideas when multiple are printed at the same time. By default, equal to \texttt{-1}.
\end{itemize}
\par Note: due to some strange problems on LaTeX/Lua connection, for ideas with exactly one dependency, the \{\} needs to be duplicated, while for multi dependency there is no need.
\par Example:
\begin{verbatim}
\createIdea[somePrefix]{Not So Great Idea}{
\par Boring content
}[]["tag2"][1]

\createIdea[somePrefix]{Great Idea}{
 \par Long content
 \par Very Interesting
}[{{"somePrefix", "Not So Great Idea"}}]["tag1"][13]
\end{verbatim}

\subsection{\textbackslash{}printIdea}
\begin{verbatim}
\printIdea[prefix][style]{name}
\end{verbatim}

\begin{itemize}
\item \texttt{prefix}: prefix to locate the idea in. By default, equals to \texttt{default}.
\item \texttt{style}: style for printing the idea. For options, see later.
\item \texttt{name}: name of the idea.
\end{itemize}

\par Example:
\begin{verbatim}
\printIdea[somePrefix][lcbf]{Great Idea}
\end{verbatim}

\subsection{\textbackslash{}printAllWithPrefix}
\begin{verbatim}
\printIdea[prefix][style]
\end{verbatim}

\begin{itemize}
\item \texttt{prefix}: prefix to print.
\item \texttt{style}: style for printing the idea. For options, see later.
\end{itemize}

\par Example:
\begin{verbatim}
\printIdeaAllWithPrefix[somePrefix][lcbf]
\end{verbatim}

\subsection{\textbackslash{}printAllWithTag}
\begin{verbatim}
\printIdea[prefix][style]{tag}
\end{verbatim}

\begin{itemize}
\item \texttt{prefix}: prefix to locate the ideas in.
\item \texttt{style}: style for printing the idea. For options, see later.
\item \texttt{tag}: tag to print
\end{itemize}

\par Example:
\begin{verbatim}
\printIdeaAllWithTag[somePrefix][lcbf]{tag1}
\end{verbatim}

\section{Style}
\par Printing style is decided by one letter flags.
\begin{itemize}
\item \texttt{f}: Frame whole idea
\item \texttt{c}: Center whole idea
\item \texttt{b}: Create bookmark leading to the idea
\item \texttt{l}: Use large font for the name
\item \texttt{s}: Reserve some space using needspace to avoid awkward pagebreaks
\item \texttt{e}: emph the name
\item \texttt{q}: do not print the name
\end{itemize}

\section{Example}
\subsection{Code}
\begin{verbatim}
\createIdea[somePrefix]{Not So Great Idea}{
\par Boring content
}[]["tag2"][1]

\createIdea[somePrefix]{Great Idea}{
\par Long content
\par Very Interesting
}[{{"somePrefix", "Not So Great Idea"}}]["tag1"][13]

\createIdea[somePrefix2]{Third Idea}{
\par Third try is even longer
\par But not very
\par Only 3 lines
}[{"somePrefix", "Not So Great Idea"}, {"somePrefix", "Great Idea"}][][21]

\par Here is a Great Idea:
\printIdea[somePrefix][lcf]{Great Idea}
\vspace{1em}
\par Here are all ideas in prefix \texttt{somePrefix}:
\printAllWithPrefix[somePrefix][lcf]
\vspace{1em}
\par Here are all ideas in prefix \texttt{somePrefix} with tag \texttt{tag1}:
\printAllWithTag[somePrefix][lcf]{tag1}
\vspace{1em}
\par And here is Third Idea, presenting nested dependencies:
\printIdea[somePrefix2][lcf]{Third Idea}

\end{verbatim}
\subsection{Result}

\createIdea[somePrefix]{Not So Great Idea}{
\par Boring content
}[]["tag2"][1]

\createIdea[somePrefix]{Great Idea}{
\par Long content
\par Very Interesting
}[{{"somePrefix", "Not So Great Idea"}}]["tag1"][13]

\createIdea[somePrefix2]{Third Idea}{
\par Third try is even longer
\par But not very
\par Only 3 lines
}[{"somePrefix", "Not So Great Idea"}, {"somePrefix", "Great Idea"}][][21]

\par Here is a Great Idea:
\printIdea[somePrefix][lcf]{Great Idea}
\vspace{1em}
\par Here are all ideas in prefix \texttt{somePrefix}:
\printAllWithPrefix[somePrefix][lcf]
\vspace{1em}
\par Here are all ideas in prefix \texttt{somePrefix} with tag \texttt{tag1}:
\printAllWithTag[somePrefix][lcf]{tag1}
\vspace{1em}
\par And here is Third Idea, presenting nested dependencies:
\printIdea[somePrefix2][lcf]{Third Idea}

\end{document}