Como posso mostrar caixas de código?

Question

Estou escrevendo um manual simples. Nele, explico como configurar os arquivos e programas necessários para executar um pipeline que escrevi. Eu gostaria de incluir comandos de linha de comando nesse arquivo de uma forma que os destaque e sejam fáceis de ler.

Basicamente, como posso obter esse efeito no meu documento LaTeX:

cd ~/foo; mkdir bar

Eu estava pensando em uma \parboxe uma cor de fundo, mas esperava que houvesse uma classe que simplificasse esse ou qualquer outro truque. Não preciso de destaque de código, só preciso de uma maneira fácil de diferenciar comandos de prosa.

Answer 1

Eu sugeriria usar o verbatimambiente, pois é simples e deve fornecer a distinção que você procura. Aqui está um exemplo mínimo:

\documentclass{article}
\begin{document}
I am in the process of writing a simple manual. In it, I explain how to set up the 
files and programs necessary to run a pipeline I have written. I would like to include 
command line commands in that file in a way that makes them stand out and easy to read.

Basically, how can I get this effect in my LaTeX document:
\begin{verbatim}
cd ~/foo; mkdir bar
\end{verbatim}
I was thinking along the lines of a \verb|\parbox| and a background color but I was 
hoping there might be a class that simplifies this or any other tricks. I don't need 
code highlighting, I just need an easy way to differentiate commands from prose.
\end{document}

Talvez definindo a sua própria funcionalidade fornecida porfancyvrboulistingstambém poderia ser uma opção, como sugerido emImprima programas com sua sintaxe adequadae/ouEscrevendo código-fonte em LaTeX como texto.

Answer 2

Como uma variação do verbatimtema, o numberedblockpacote permite rotular blocos de código com um número marginal e referenciá-los com \ref. Dependendo da sua aplicação, isso também pode ser útil. (verhttp://ctan.org/pkg/numberedblock)

\documentclass{article}
\usepackage{numberedblock}
\begin{document}
I am in the process of writing a simple manual. In it, I explain how to set up the 
files and programs necessary to run a pipeline I have written. I would like to include 
command line commands in that file in a way that makes them stand out and easy to read.

Basically, how can I get this effect in my LaTeX document:

\begin{numVblock}[\nbVlabel{nb:A}]
cd ~/foo; mkdir bar
\end{numVblock}

I was thinking along the lines of a \verb|\parbox| and a background color but I was 
hoping there might be a class that simplifies this or any other tricks. I don't need 
code highlighting, I just need an easy way to differentiate commands from prose.

I can number larger blocks

\begin{numVblock}[\nbVlabel{nb:B}]
      program test
      implicit none
      integer a, x
c$$$$$$$$$$$$$$$$$$$$$$$$$
      a = 0
      x = 1
   10 a = a + x
      if (a .eq. 100) stop
      goto 10
      end
\end{numVblock}

\noindent and can then reference code blocks \ref{nb:A} and \ref{nb:B}.
\end{document}