better listings in guide pdf

extensions/apidoc/templates/pdf/main.tex

@@ -21,32 +21,41 @@
 \definecolor{mygray}{rgb}{0.5,0.5,0.5}
 \definecolor{mymauve}{rgb}{0.58,0,0.82}
 
+% TODO ensure copyable indentation:
+% http://tex.stackexchange.com/questions/142617/copy-pasting-leading-whitespace-and-blank-lines-in-listings-package-pdf
+
 \lstset{%
   backgroundcolor=\color{codebg},   % choose the background color; you must add \usepackage{color} or \usepackage{xcolor}
-  basicstyle=\footnotesize,        % the size of the fonts that are used for the code
+  basicstyle=\ttfamily\footnotesize, % the size of the fonts that are used for the code
+  columns=fullflexible,
   breakatwhitespace=false,         % sets if automatic breaks should only happen at whitespace
   breaklines=true,                 % sets automatic line breaking
-  captionpos=b,                    % sets the caption-position to bottom
-  commentstyle=\color{mygreen},    % comment style
-% deletekeywords={...},            % if you want to delete keywords from the given language
-  escapeinside={\%*}{*)},          % if you want to add LaTeX within your code
   extendedchars=true,              % lets you use non-ASCII characters; for 8-bits encodings only, does not work with UTF-8
-% frame=single,                    % adds a frame around the code
   keepspaces=true,                 % keeps spaces in text, useful for keeping indentation of code (possibly needs columns=flexible)
+%
+  commentstyle=\color{mygreen},    % comment style
   keywordstyle=\color{blue},       % keyword style
+  stringstyle=\color{mymauve},     % string literal style
+%
 % language=Octave,                 % the language of the code
 % morekeywords={*,...},            % if you want to add more keywords to the set
-  numbers=left,                    % where to put the line-numbers; possible values are (none, left, right)
+% deletekeywords={...},            % if you want to delete keywords from the given language
+%
+  numbers=none,                    % where to put the line-numbers; possible values are (none, left, right), not using line numbers to allow copy&paste
+  stepnumber=1,                    % the step between two line-numbers. If it's 1, each line will be numbered
   numbersep=5pt,                   % how far the line-numbers are from the code
   numberstyle=\tiny\color{mygray}, % the style that is used for the line-numbers
-  rulecolor=\color{black},         % if not set, the frame-color may be changed on line-breaks within not-black text (e.g. comments (green here))
+%
   showspaces=false,                % show spaces everywhere adding particular underscores; it overrides 'showstringspaces'
   showstringspaces=false,          % underline spaces within strings only
   showtabs=false,                  % show tabs within strings adding particular underscores
-  stepnumber=1,                    % the step between two line-numbers. If it's 1, each line will be numbered
-  stringstyle=\color{mymauve},     % string literal style
+%
   tabsize=2,                       % sets default tabsize to 2 spaces
-  title=\lstname                   % show the filename of files included with \lstinputlisting; also try caption instead of title
+%  title=\lstname                   % show the filename of files included with \lstinputlisting; also try caption instead of title
+%
+    literate={-}{-}1,
+    %    {\'}{'}1,
+    %    {\"}{\"}1
 }
 
 \lstdefinelanguage{json}{
@@ -88,9 +97,6 @@
     many contributors from the Yii community
 }
 
-%\setlength{\oddsidemargin}{15.5pt}
-%\setlength{\evensidemargin}{15.5pt}
-
 % uncomment for debugging layout issues
 %\usepackage{showframe}