%\documentclass[11pt,twoside,draft]{article}
\documentclass[11pt,twoside]{article}

\usepackage{baaa-cas}
\usepackage{graphicx}
\usepackage{subfigure}
\usepackage{psfrag}

\usepackage[spanish]{babel}
\usepackage[latin1]{inputenc}

\usepackage[T1]{fontenc} % Computer Modern (CM) fonts
\usepackage{ae,aecompl} % and: dvips -Pcmz -Pamz macros_aaa.dvi

\usepackage{latexsym}
\usepackage{verbatim}
\usepackage[colorlinks=true,dvips]{hyperref}

\begin{document}
\vskip 1.0cm
\markboth{F. A. Bareilles et al.}%
{Algunas contribuciones para el {\em template} de la AAA}

\pagestyle{myheadings}
%%%% DESCOMENTE LA LINEA QUE DESCRIBE EL CARACTER DE SU TRABAJO %%%%%%
\vspace*{0.5cm}
%\parindent 0pt{INFORME INVITADO          -- INVITED REVIEW} 
\parindent 0pt{ COMUNICACI\'ON DE TRABAJO -- CONTRIBUTED  PAPER } 
\vskip 0.3cm
\title{Algunas contribuciones para el {\em template} de la AAA}

\author{F. A. Bareilles$^{1,2}$ , 
Profesor Neurus$^{3}$}

\affil{%
  (1) Instituto Argentino de Radioastronom\'{\i}a (IAR)\\
  (2) Facultad de Ciencias Astron\'omicas y Geof\'{\i}sicas - UNLP\\
  (3) Laboratorio de Neurus\\
}


\begin{resumen}
  Se presentan algunas sugerencias y críticas para ser consideradas en
  los futuros {\em templates} de los {\em proceedings} de la AAA.
\end{resumen}


\section{Introducci\'on}
De examinar la documentación suministrada para confeccionar los
trabajos que formarán parte del Bolet\'\i n de la Asociaci\'on
Argentina de Astronom\'\i a (BAAA), me surgen numerosos comentarios y
sugerencias para realizar a quienes confeccionarán el BAAA.

Se trata solamente de cuestiones relacionadas con el lenguaje \LaTeX{},
y más específicamente \LaTeXe{}, no al estilo de diagramación de los
documentos.

\section{?`Debemos usar {\tt\char '134documentstyle} ó
  {\tt\char '134documentclass}?} 
 El {\em template} comienza con:

\begin{verbatim}
\documentstyle[11pt,baaa-cas,twoside,epsf,psfig]{article}
\end{verbatim}
 
 Esta inocente declaración implica que {\bf no} se hará uso de
 \LaTeXe{} ({\em Latex} extendido), sino que será un documento en
 \LaTeX{} versión 2.09; también conocido como {\tt latex209}. Éste fue
 declarado
 obsoleto en 1994 (ver:\\
 \href{http://www.latex-project.org/ltnews/ltnews01.pdf}
 {http://www.latex-project.org/ltnews/ltnews01.pdf}); se soporta sólo
 por compatibilidad, trabajando un 50\% más lento que {\tt\char
   '134documentclass} (modo nativo actual). El último párrafo de la
 página de manual de \LaTeX{} dice:
\begin{verbatim}
       On some systems latex209 and slitex are available for com­
       patibility with older versions of LaTeX.  These should not
       be used for new texts.
\end{verbatim}


\subsection{Sintaxis de {\tt\char '134documentclass}}
El uso de {\tt\char '134documentclass} difiere un poco de {\tt\char
  '134documentstyle} en lo que refiere al ``[...]''; su uso es ahora
para pasar opciones y no paquetes de estilo. La declaración quedaría
así:

\begin{verbatim}
\documentclass[11pt,twoside]{article}
\usepackage{baaa-cas}
\usepackage{epsf}
\usepackage{psfig}
\end{verbatim}

pero el uso de {\tt epsf} y {\tt psfig} también es obsoleto como
veremos en la próxima sección.

\section{Uso de gráficos en \LaTeXe}
\subsection{Algo de historia}
Cuando \TeX~ fue escrito, no existían los formatos gráficos
PostScript/eps, jpeg, gif, motivo por el cual el formato {\bf dvi}
({\em DeVice Independent}) no tiene un soporte directo para importar
gráficos. Pero {\bf dvi} sí permite que se pasen comandos a los
programas interpretes de éste, lo que permitió que \TeX~ y \LaTeX{}
incluyan gráficos dentro del formato {\bf dvi}. El uso más normal de
{\bf dvi} fue su conversión a PostScript, lo que hizo que {\bf eps}
(Encapsulated PostScript) sea el formato más usado y aceptado. Los
paquetes {\tt psfig} y {\tt epsf} fueron los primeros en dar solución
a la inclusión de gráficos en \LaTeX{} 2.09, pero nunca alcanzaron la
robustez requerida.

Con la llegada de \LaTeXe{} en 1994 se reescribió completamente el
paquete para la inclusión de gráficos, construyendo los paquetes {\tt
  graphics} y {\tt graphicx} (ambos excluyentes, ya que los dos
utilizan {\tt\char '134includegraphics} como comando para incluir
gráficos). El único que permite opciones es {\tt graphicx} (la ``x''
es por {\em extended}), por lo que es actualmente el paquete
más aceptado. Puede encontrarse mucha más información en:\\
\href{ftp://ctan.tug.org/tex-archive/info/epslatex.pdf}%
{ftp://ctan.tug.org/tex-archive/info/epslatex.pdf}

\subsection{Distribución de paquetes}
Junto con los ejemplos ({\em templates}) y los archivos de estilo para
la publicación, se incluyó el paquete {\tt psfig.sty} (v 1.9). Esto no
es lo habitual, ya que es un paquete estándar y común a \TeX, por lo
que ya existe una versión del mismo en cada compilador.

Si existe un motivo de peso por el cual se deba utilizar éste y no el
que existe en cada sistema, debería existir una aclaración con el
motivo de su uso, ya que no es un paquete aislado, y otros dependen de
él. En este caso en particular, la versión distribuida es anterior a
la presente en cualquier \LaTeX{} con menos de 8 años.


\subsection{Discusión sobre la inclusi\'on de Tablas y Figuras}
En la sección ``Ejemplos de inclusi\'on de Tablas y Figuras'' del {\em
  template} se encuentra una llamada de atención que dice:

\begin{quote}
\underline{ Atenci\'on:} Este macro siempre trata de ubicar las figuras 
al comienzo de una p\'agina, no importa
d\'onde las incluy\'o el autor en el texto.
\end{quote}

No queda claro si ésta es la intención de los editores o se desconoce
la forma de instruir al \LaTeX{} cómo hacerlo de manera diferente.

Las figuras que se incluyen con una declaración de entorno del tipo:

\begin{verbatim}
\begin{figure}
...
\end{figure}
\end{verbatim}
son llamadas ``cuerpos flotantes'', y se proveen distintos
modificadores para indicar su ubicación:

\begin{verbatim}
\begin{figure}[especificación de posición]
...
\end{figure}
\end{verbatim}

En la tabla \ref{tab:permiss} se listan los valores posibles de
``especificación de posición''.

\begin{table}[!ht]
  \begin{center}
    \begin{tabular}{@{}cp{.65\textwidth}@{}}
      Espec.& Descripción\\
      \hline
      \rule{0pt}{1.05em}
      \texttt{h} & (\emph{here}) ubicar la figura aquí donde fue 
      especificada.\\[0.3ex]
      \texttt{t} & (\emph{top}) al comienzo de la página.\\[0.3ex]
      \texttt{b} & (\emph{bottom}) al final de la página\\[0.3ex]
      \texttt{p} & (\emph{page}) en una página aparte (flotante).\\[0.3ex]
      \texttt{!} & Es algo así como: ``tratar realmente de hacerlo''\\
    \end{tabular}
  \end{center}
  \caption{Opciones para los ``cuerpos flotantes''}\label{tab:permiss}
\end{table}

Cuando no se especifica la ubicación, las opciones que se asumen son
\verb+[tbp]+; este es el motivo por el cual las figuras del ejemplo
siempre caen al comienzo de la página ({\tt t}) o al final ({\tt b}) o
en otra página como la figura 2 del {\em template}.

Las opciones más usadas suelen ser: \verb+[!ht]+.



\subsection {Ejemplos de inclusi\'on de Tablas y Figuras}
En lo que sigue se utiliza el paquete {\tt graphicx} y {\tt
  subfigure}; este último es totalmente opcional, pero se incluyen
ejemplos de su uso:

\begin{verbatim}
\usepackage{graphicx}
\usepackage{subfigure}
\end{verbatim}

Con respecto a la figura {\tt figure1a.eps}: fue generada como {\tt
  .eps} con {\em AIPS} (tarea {\em LWPLA}) y luego convertida a {\em
  PostScript} con {\tt xfig} (nombre original: {\tt ls-snr.xfig.ps});
el {\em Bounding Box} fue modificado para que se vea el área correcta,
pero en rigor no es un {\tt .eps}, es un {\tt .ps}. La versión {\tt
  figure1a2.eps} corrige esto.


En la figura \ref{fig:ab1} se incluyen los dos archivos en forma
equivalente al {\em template} de la siguiente manera:

\begin{verbatim}
\begin{figure}[!ht]
  \centering
  \includegraphics[width=.45\textwidth]{figure1a2.eps}~\hfill
  \includegraphics[width=.45\textwidth]{figure1b2.eps}
  \caption{{\it Izquierda:} Extra\~no manch\'on de origen 
    desconocido.\protect\\{\it Derecha:} Perfiles radiales del manch\'on.}
  \label{fig:ab1}
\end{figure}
\end{verbatim}

Nótese que no se especifica un tamaño fijo en centímetros, pulgadas o
puntos; en su lugar se utiliza un porcentaje sobre el ancho del texto
\verb+\textwidt+ (un 45~\%). Esto hace más dinámico el documento y
menos sensible a variaciones del ancho de la página. El \verb+~\hfill+
en el medio de las figuras llena el espacio que queda (10 \%) entre
ambas.

Se utilizó \verb+\centering+ para el centrado de la figura
\ref{fig:ab1}: esto es más apropiado que
\verb+\begin{center}...\end{center}+, ya que no realiza la inclusión
de un espacio que sí produce esto último. En rigor para la figura
\ref{fig:ab1}, el centrado está de más, ya que se utiliza el 100 \%
del ancho.

En el \verb+\caption{...}+ se utiliza \verb+\protect\\+ para producir
una nueva línea en éste.


\begin{figure}[!ht]
  \centering
  \includegraphics[width=.45\textwidth]{figure1a2.eps}~\hfill
  \includegraphics[width=.45\textwidth]{figure1b2.eps}
  \caption{{\it Izquierda:} Extra\~no manch\'on de origen 
    desconocido.\protect\\{\it Derecha:} Perfiles radiales del manch\'on.}
  \label{fig:ab1}
\end{figure}


En la figura \ref{fig:ab2} se utilizó un 35~\% para cada imagen y se
distribuyó el 30~\% restante a izquierda, centro y derecha, de la
siguiente manera:

\begin{verbatim}
\begin{figure}[!ht]
  \centering
  \hfill\includegraphics[width=.35\textwidth]{figure1a2.eps}~\hfill
  \includegraphics[width=.35\textwidth]{figure1b2.eps}\hfill~
  \caption{{\it Izquierda:} Extra\~no manch\'on de origen 
    desconocido.\protect\\{\it Derecha:} Perfiles radiales del manch\'on.}
  \label{fig:ab2}
\end{figure}
\end{verbatim}

\begin{figure}[!ht]
  \centering
  \hfill\includegraphics[width=.35\textwidth]{figure1a2.eps}~\hfill
  \includegraphics[width=.35\textwidth]{figure1b2.eps}\hfill~
  \caption{{\it Izquierda:} Extra\~no manch\'on de origen 
    desconocido.\protect\\{\it Derecha:} Perfiles radiales del manch\'on.}
  \label{fig:ab2}
\end{figure}

Otra herramienta que nos provee \LaTeXe{}, es el uso del paquete {\tt
  subfigure}. En la figura \ref{fig:ab3} podemos referenciar la figura
\ref{fig:ab3:a} y \ref{fig:ab3:b} separadamente, como muestra el
siguiente ejemplo:

\begin{verbatim}
\begin{figure}[!ht]
  \centering
  \hfill%
  \subfigure[Extra\~no manch\'on de origen desconocido]{%
    \label{fig:ab3:a}%
    \includegraphics[width=.35\textwidth]{figure1a2.eps}}~\hfill
  \subfigure[Perfiles radiales del manch\'on.]{%
    \label{fig:ab3:b}%
    \includegraphics[width=.35\textwidth]{figure1b2.eps}}\hfill~
  \caption{Aparentemente una tomografía del cerebro del autor.}
  \label{fig:ab3}
\end{figure}
\end{verbatim}

El uso de \% en el ejemplo de la figura \ref{fig:ab3}, no es opcional:
está deliberadamente puesto para que \LaTeX{} no reemplace por espacios
cada fin de línea.

\begin{figure}[!ht]
  \centering
  \hfill%
  \subfigure[Extra\~no manch\'on de origen desconocido]{%
    \label{fig:ab3:a}%
    \includegraphics[width=.35\textwidth]{figure1a2.eps}}~\hfill
  \subfigure[Perfiles radiales del manch\'on.]{%
    \label{fig:ab3:b}%
    \includegraphics[width=.35\textwidth]{figure1b2.eps}}\hfill~
  \caption{Aparentemente una tomografía del cerebro del autor.}
  \label{fig:ab3}
\end{figure}


\subsection{Reemplazo de textos en figuras}
Esto es ya un poco superfluo, pero puede ser una herramienta muy útil.
Muchas veces nos queda una figura donde hay que hacer un cambio
realmente menor en algún cartel o etiqueta. De esto se encarga el
paquete {\tt psfrag}:
\begin{verbatim}
\usepackage{psfrag}
\end{verbatim}

Imaginemos el siguiente escenario: el referí nos dice que los carteles
de ``{\tt RIGHT ASCENSION}'' y ``{\tt DECLINATION}'' de la figura
\ref{fig:ab3:a} deben estar en castellano o $\alpha$ y $\delta$ - Pero
esa figura la hice hace 8 meses y ni me acuerdo con qué -. Bueno,
usemos {\tt psfrag} para el reemplazo (figura \ref{fig:psfrag}):

\begin{verbatim}
\begin{figure}[!ht]
  \centering
  \includegraphics[width=.45\textwidth]{figure1a2.eps}~\hfill
  \psfrag{RIGHT ASCENSION (J2000)}[tc][]{{\tiny $\alpha$ (J200)}}
  \psfrag{DECLINATION (J2000)}[tc][]{{\tiny $\delta$ (J200)}}
  \includegraphics[width=.45\textwidth]{figure1a2.eps}
  \caption{{\it Izquierda:} la original.
    {\it Derecha:} la requerida por el referí.}
  \label{fig:psfrag}
\end{figure}
\end{verbatim}

La documentación detallada para su uso se encuentra en:\\
\href{ftp://ctan.tug.org/tex-archive/info/epslatex.pdf}%
{ftp://ctan.tug.org/tex-archive/info/epslatex.pdf}

\begin{figure}[!ht]
  \centering
  \includegraphics[width=.45\textwidth]{figure1a2.eps}~\hfill
  \psfrag{RIGHT ASCENSION (J2000)}[tc][]{{\tiny $\alpha$ (J200)}}
  \psfrag{DECLINATION (J2000)}[tc][]{{\tiny $\delta$ (J200)}}
  \includegraphics[width=.45\textwidth]{figure1a2.eps}
  \caption{{\it Izquierda:} la original.
    {\it Derecha:} la requerida por el referí.}
  \label{fig:psfrag}
\end{figure}


\section{Paquete {\tt babel}}
Si no se pide otra cosa, \LaTeX{} asume que el documento se escribe en
inglés; no es éste el caso y no será el caso de quienes usen la macro
para castellano. La herramienta que nos provee \LaTeX{} es {\tt
  babel}: su uso hará que el corte de palabras sea con nuestras reglas
gramaticales y se traduzcan todos los títulos como sección, capítulo,
figura, etc. Si bien esto último ya está hecho en {\tt baaa-cas.sty}
manualmente, pudo hacerse simplemente incluyendo el lenguaje correcto:

\begin{verbatim}
\usepackage[spanish]{babel}
\end{verbatim}

\section{Acentos y caracteres especiales}
Es común escuchar a quienes recién se inician con \LaTeX{} protestar
porque poner un acento implica usar la ``\verb+\'+'', y ni hablar de
obtener una `` {\bf í} '' (\verb+\'{\i}+). Con el tiempo se
acostumbran y se olvidan del tema; pero \LaTeX{} provee dos mecanismos
alternativos muy cómodos para que esto sea muy sencillo; e incluso
sea muy fácil incluir texto proveniente de otro lado como {\tt html} o
algún procesador de textos tipo {\em word} sin necesidad de tocar
acentos, eñes y demás.

Un mecanismo es la opción {\tt activeacute} en el paquete {\tt babel},
con el cual la secuencia \verb+'a 'e 'i 'o 'u ~n+ produce á é í ó ú ñ;
pero esto no soluciona el problema de importar texto. El mecanismo que
puede resultar más adecuado es pedirle a \LaTeX{} que utilice nuestro
set de caracteres {\bf ISO-8859-1} conocido como {\bf\em latin1}; para
ello:

\begin{verbatim}
\usepackage[latin1]{inputenc}
\end{verbatim}

Ahora debo apelar a la credulidad del lector, y que usted crea cuando
le digo que este texto está escrito tal cual: á é í ó ú ñ ü ¿? ¡!.


\subsection{Codificación de caracteres: ?`7 u 8 bit?}
Ésta es la segunda parte de la historia, ya que por defecto \LaTeX{}
usa una codificación de 7 bits (OT1). Esto no ocasiona ningún problema
si no usamos acentos, eñes y demás, pero sí a nosotros. ?`Nunca tuvo
problemas con el corte de palabras acentuadas, por mas que las
agregara al {\verb+\hyphenation{}+}?

La solución a esto y un correcto espaciado de caracteres la da el uso
de 8 bits (T1) para la codificación de caracteres con el paquete {\tt
  fontenc} y fuentes {\em Computer Modern (CM)}:

\begin{verbatim}
\usepackage[T1]{fontenc}
\usepackage{ae,aecompl}
\end{verbatim}


\section{?`Qué tipos de fuentes usar?}
El tema es extremadamente extenso y escapa su complejidad a mis
conocimientos; pero básicamente podemos usar dos grandes familias de
fuentes: estáticas ({\em bitmaped}) y dinámicas (o escalables).

El uso de fuentes estáticas es adecuado para una versión final en {\em
  PostScript}; pero es inadecuada para {\em PDF}. En la mayoría de los
sistemas actuales si no se especifica otra cosa, estamos usando
fuentes estáticas; el resultado podemos verlo en la figura
\ref{fig:font:t1} (el efecto es valido únicamente si usted esta viendo
la versión PDF). Otro ejemplo es el boletín 47 de la AAA publicado
hasta el 16 de diciembre de 2005:
\href{http://www.astronomiaargentina.org.ar/b47/boletin47.pdf}%
{http://www.astronomiaargentina.org.ar/b47/boletin47.pdf}; la misma
versión puede encontrarse en:\\
\href{http://www.iar.unlp.edu.ar/~fede/pub/aaa/boletin47.pdf}%
{http://www.iar.unlp.edu.ar/$\sim$fede/pub/aaa/boletin47.pdf}

\begin{figure}[!ht]
  \centering
  \includegraphics[width=\textwidth]{font_7b.eps}
  \caption{Despliegue de un {\em PDF} con fuentes estáticas}
  \label{fig:font:t1}
\end{figure}

En cambio, las fuentes dinámicas son útiles tanto para las versiones
{\em PostScript} como {\em PDF} del documento. Si usted está viendo la
versión {\em PDF} de este documento, entonces ve el resultado de usar
fuentes dinámicas (figura \ref{fig:font:ot1}).

\begin{figure}[!ht]
  \centering
  \includegraphics[width=\textwidth]{font_8b.eps}
  \caption{Despliegue de un {\em PDF} con fuentes dinámicas}
  \label{fig:font:ot1}
\end{figure}

\vbox{%
Se puede configurar {\tt dvips} para que utilice fuentes dinámicas
incluyendo el siguiente texto en el archivo {\tt \$HOME/.dvipsrc}: 

\begin{verbatim}
p +psfonts.cmz
p +psfonts.amz
\end{verbatim}
}
Otra forma de lograr lo mismo, es especificarlo directamente en la
línea de comandos de {\tt dvips}:

\begin{verbatim}
$ dvips -Pcmz -Pamz macros_aaa.dvi -o macros_aaa.ps
\end{verbatim}%$


\section{Documentos electrónicos}
El hecho de que el Boletín de la AAA sea electrónico, nos permitiría
utilizar hiper vínculos (o referencias dinámicas) dentro de los mismos.
Esta ventaja es inútil para la documentación en papel o {\em
  PostScript} obviamente, sólo será útil en la versión PDF.

Este documento está utilizando referencias dinámicas, y si usted está
leyendo la versión PDF, verá que en esta cita de la tabla
\ref{tab:permiss} de la página \pageref{tab:permiss}, los números
tienen otro color y pueden ser utilizados para ir a la tabla
\ref{tab:permiss} o la página \pageref{tab:permiss} en forma dinámica.
Lo mismo ocurre con el {\em bookmark} que posee, por ejemplo, el {\em
  Acrobat Reader} (donde puede verse un índice electrónico del
documento, aunque no exista un índice en el documento).


\subsection{Paquete {\tt hyperref}}
Este paquete es parte de {\em HyperTEX project}
(\href{http://arxiv.org/hypertex/}{http://arxiv.org/hypertex/}).
Extiende las funcionalidades de las referencias cruzadas en \LaTeX{}
(incluyendo: secciones, tablas, figuras, bibliografia, etc.),
permitiéndonos hacer dinámico el documento, tanto con referencias
locales como externas. La forma más normal para su uso es:

\begin{verbatim}
\usepackage[colorlinks=true,dvips]{hyperref}
\end{verbatim}

\noindent donde {\tt colorlinks} puede ser {\tt false} o {\tt true}, y {\tt
  dvips} es necesario para que se encapsule la información dentro del
{\tt dvi}.

Simplemente incluyendo el paquete con esas opciones, todas las
referencias pasan a ser dinámicas (éstas son las locales).

Las referencias externas se realizan con \verb+\href{referencia}{texto}+;
por ejemplo:\\
\verb+\href{%+\\
\verb+ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/%+\\
\verb+hyperref/doc/manual.html}{aquí}+\\
produce: 
\href{
ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/hyperref/doc/manual.html}
{aquí}

Más información puede encontrarse en:\\
\href{%
  ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf}
{\small %
ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf}\\
o
\href{%
ftp://tug.ctan.org/pub/tex-archive/macros/latex/contrib/hyperref/doc/manual.pdf}
{aquí}

La versión \LaTeXe{} de éste documento puede encontrarse en:\\
 \href{http://www.iar.unlp.edu.ar/~fede/pub/aaa/}%
{http://www.iar.unlp.edu.ar/$\sim$fede/pub/aaa/}

%\newpage
%\section{Código utilizado}
%\verbatiminput{macros_aaa.tex}

\end{document}
