(texto non actualizado, estamos en obras ata rematar o verán!)

Revista MOMENTUM

Este é repositorio oficial da revista MOMENTUM, creada de 0 por estudantes de grao, máster e doutorado de Física na USC.

Contidos

1. ¿Como contribuír á revista?
2. Estrutura do repositorio
3. Estrutura das revistas
   • Revistas
   • Artigos
   • Imaxes
   • Portada
4. Compilación
   • Algunhas dependencias
   • ¿Pero como compilo isto?

¿Como contribuír á revista?

A mellor maneira de contribuír é enviándonos artigos para publicar ao correo [email protected] As contribucións en forma de código aquí en github están limitadas a temas de formato, estilos e similares. Os artigos sempre deben pasar polo correo para ser sometidos a triaxe. En xeral, as contribucións son abertas a todo o mundo. Encargámonos de dar prioridade aos artigos enviados antes, ou aos que necesitan urxencia, pero non queremos preferenciar a ninguén. Queremos que todas as persoas poidan participar neste proxecto. Se tendes dúbidas, podedes preguntar polo grupo de whatsapp da DAF, ou mellor, polo da revista.

Estrutura do repositorio

.
├── revista.cls
├── portada.tex
├── contraportada.tex
│
├── artigo_simplificado.tex
│
├── bibliografia.bib
├── latexmkrc
├── Makefile
├── README.md
├── .gitignore
│
├── logos/
│  ├── logo1.eps
│  └── logo2.pdf
│
├── fontes/
│  └── comic_sans/
│
└── revistas/
   ├── 001/
   │  ├── revista_001.tex
   │  ├── nome_apelidos_HISTORIA_DA_CIENCIA.tex
   │  └── imaxes/
   │     ├── portada_001.png
   │     └── unha_imaxe.jpg
   ├── 002
   │  └── ...
   ├── 003
   │  └── ...
   ├── 004
   │  └── ...
   └── 005
      └── ...

Estrutura das revistas

Revistas

Os arquivos comúns a todas as revistas, como o estilo xeral da portada, contraportada, ou o estilo xeral da revista están na raíz do proxecto.

Cada revista individual está dentro do seu propio cartafol. Cada un destes directorios está dentro de revistas/, ousexa temos cartafoles como revistas/001/, revistas/002/, etc. Dentro destes é onde se gardan os arquivos específicos, como os propios artigos formateados, e as imaxes, de cada revista.

O arquivo principal de cada revista noméase como revistas/001/revista_001.tex. Este é o arquivo principal a compilar, e ten a forma seguinte (aproximada)

\documentclass{revista}

% comandos para definir a informacion de cada revista
\Numero{001}
\Data{Xaneiro do 1900}
\ImaxePortada{./revistas/001/imaxes/cern.png}
\ComentarioImaxePortada{ Imaxe da portada }
\CorResalte{ff0000} % cores especificos de cada revista, con codigos HTML hex
\CorTextoEnResalte{000000}
\SobreMomentum{ Esta é a revista momentum! }
\Participantes{
    {\Large \textbf{Dirección:}}     \\[0.5cm]
        Carl Sagan                   \\[0.2cm]
    {\Large \textbf{Edición}}        \\[0.5cm]
        Albert Einstein              \\[0.2cm]
    {\Large \textbf{Diseño de Logo}} \\[0.5cm]
        Dirac                        \\[0.2cm]
}
\Despedida{ Adeus! }
\Agradecementos{ Grazas a Todos! }

\begin{document}
\input{portada.tex}
\input{indice.tex}

\input{./revistas/001/nome_apelido_HISTORIA_DA_CIENCIA.tex}
\input{./revistas/001/nome_apelido_SALSEO_NA_FACULTADE.tex}

\input{contraportada.tex}
\end{document}

Os comandos \Numero, \Data, \ImaxePortada, \ComentarioImaxePortada, \SobreMomentum, \Despedida, \Agradecementos, \CorResalte, \CorTextoEnResalte \Participantes, e os \definecolor deben usarse en cada revista xa que conteñen información específica para cada número. Están explicados na clase da revista.

Adicionalmente, os macros \LinkRepositorio, \Correo, \Drive, \WhatsApp defínense na propia clase da revista porque, en principio, conteñen información que non tería sentido cambiar entre os números.

Para mostrar calquera desos valores só hai que prefixar o macro con imprime, e.g. \imprimeCorreo, ou \imprimeNumero

Artigos

Gárdanse no mesmo directorio que o revista_001.tex correspondente, simplemente se inclúen no arquivo principal usando \input{artigo.tex}. Teñen a forma seguinte

\Titular*% este comando permite definir a información concreta de cada artigo.
{Nome do artigo}
{Axl Rose}
{divulgacion}
{
Pequeno subtítulo para o artigo. Preferiblemente, non moi longo para que non
lle coma moito espazo ao artigo en sí.
}

\begin{refsection}   % para que a bibliografía aplique solo a este artigo
\begin{multicols}{2} % para ter varias columnas

% as distintas partes sepáranse con 'subsections' SEMPRE
\subsection*{Introdución}

bla blah blah

\subsection*{Outra sección}
....
....

\printbibliography
\end{multicols}
\end{refsection}

O macro titular é o centro de cada artigo, o cal cambia cada sección, numeracións, formatos dos encabezados, define nomes... Está definido na clase da revista. Importante botarlle un ollo ás definicións dos encabezados que se poden usar (divulgacion, historia, etc.).

Se queremos engadir unha nova sección ao índice, debemos usar o comando \Titular*, co asterisco

Imaxes

Cada revista ten as imaxes gardadas nun subcartafol ao lado do documento correspondente. Nos artigos editados só hai que facer:

\includegraphics{./revistas/001/imaxes/imaxebonita.png}

Neste proxecto usamos o sistema GIT-LFS para manexar arquivos binarios, entre os cales están as imaxes. Inda así, é recomendable que non sexan demasiado grandes. Podedes usar Gimp ou, como fago eu, convert, para reducirlles algo o tamaño.

Portada

Esperamos poder crear unha portada distinta para cada número. A imaxe correspondente defínese en cada revista_123.tex no comando \ImaxePortada. A imaxe da portada debe ter forma cadrada exactamente

COMPILACIÓN

Algunhas dependencias

Este proxecto usa LuaLaTeX para o proceso de compilación, xa que nos da vantaxes no uso de distintas tipografías, danos acceso a \directlua, e danos máis opcións de depurado usando lua-visual-debug

As tipografías usadas están incluídas no directorio fontes, polo que non é necesario instalalas.

Para os paquetes e resto de dependencias, é recomendable unha instalación completa de TeXLive, inda que seguramente MiKTeX tamén funcione. Na clase da revista inclúese un \listfiles polo que cada vez que se compila un documento deberían aparecer listados todos os ficheiros *.sty e similares que se están usando dentro da logfile.

Para o logo da USC é necesario ter epstopdf.

¿Pero como compilo isto?

Quen use sistemas online como Overleaf, poden simplemente descargar o proxecto completo premendo no botón grande e verde na páxina principal que pon CODE, e descargando un .zip. Este pode importarse normalmente a overleaf. Recordade seleccionar no panel esquerdo o arquivo principal, que será, por exemplo, revistas/001/revista_001.tex

Dado que o proxecto non está moi optimizado, fixen un arquivo simplificado chamado artigo_simplificado.tex o cal se pode compilar sen portada nin contraportada. Debería ser máis sinxelo de usar porque non hai que preocuparse pola estrutura deste proxecto, nin pola inicialización dos macros; e debería ser algo máis rápido de compilar por ser máis simple. O propio arquivo está documentado asique quen sexa curioso que o abra e o lea.

Por outro lado, para as persoas sen medo a usar un ordenador só hai que escribir na termianl, en Linux

latexmk ./revistas/001/revista_001.tex

Esto debería funcionar tamén en windows con Powershell 5 ou 7 (creo) Tamén se adxunta unha Makefile para os que usen Linux e similares. É posible facer

make numero=001 # compilar a revista numero 001
make limpa      # limpar os arquivos auxiliares

Por defecto, ca configuración de latexmk adxunta, ao compilar unha revista o PDF que se xere gárdase no directorio ./pdf/ e os arquivos auxiliares en ./aux/.

Varios links e documentos utiles

Paxinas oficiais principais

• Proxecto de Latex principal: https://www.latex-project.org/
• Arquivo principal con paquetes, documentos e ferramentas: https://www.ctan.org/
• LuaTex: https://www.luatex.org/

Documentacions e repositorios principais

LaTeX2e

• Documentos (e arquivos) base oficiais (inclue luatex en ltluatex.pdf): https://ctan.org/tex-archive/macros/latex/base
• Documentos (e arquivos) base oficiais (PRE-PUBLICACION): https://ctan.org/tex-archive/macros/latex-dev/base
• Repositorio: https://github.com/latex3/latex2e

LaTeX3 (expl3)

• Documentos (e arquivos) de LaTeX3: https://ctan.org/tex-archive/macros/latex/required/l3kernel
• Documentos (e arquivos) de LaTeX3 (PRE-PUBLICACION): https://ctan.org/tex-archive/macros/latex-dev/required/l3kernel
• Repositorio (expl3): https://github.com/latex3/latex3

Experimetal

• LaTeX Laboratory, cousas máis novedosas e en desenvolvemento, e.g. o \DocumentMetadata: https://ctan.org/tex-archive/macros/latex/required/latex-lab
• LaTeX Laboratory (PRE-PUBLICACION): https://ctan.org/tex-archive/macros/latex-dev/required/latex-lab
• Un monton de docs que están aparte (e.g. l3pdfmeta): https://ctan.org/tex-archive/macros/latex/contrib/pdfmanagement-testphase

Docs principais de Luatex

• Paquete en CTAN: https://ctan.org/pkg/luatex
• Funcions de Lua (potentes): https://ctan.org/tex-archive/macros/luatex/latex e https://ctan.org/tex-archive/macros/luatex/generic

Documentacións utiles

• Preguntas e Respostas máis importantes: https://tex.stackexchange.com/
• Overleaf Docs: https://www.overleaf.com/learn
• LaTeX Wikibook (algo desactualizado pero ten cousas da base de La/TeX moi utiles): https://en.wikibooks.org/wiki/LaTeX
• Varias referencias: https://latexref.xyz/
• Preguntas comuns: https://texfaq.org/

Simbolos e tipografias

• Mega lista de fontes: https://tug.org/FontCatalogue/
• Mega lista de simbolos: https://www.ctan.org/pkg/comprehensive

Tagging project

• Proxecto (non de LaTeX): https://taggedpdf.com/
• Introduccion ao uso do proxecto: https://latex3.github.io/tagging-project/documentation/prototype-usage-instructions
• Compatibilidade de varios paquetes e clases co proxecto: https://latex3.github.io/tagging-project/tagging-status/
• Proxecto en CTAN, coa documentación oficial: https://www.ctan.org/pkg/tagpdf
• Repositorio de tagpdf: https://github.com/latex3/tagpdf

Outros

• Lista con moitas cousas LaTeXeras: https://github.com/egeerardyn/awesome-LaTeX
• Logotipia de LaTeX: https://github.com/latex3/branding