LaTeX es una extensión a un sistema llamado TeX, desarrollado para escribir documentos de matemáticas. A continuación se presenta un ejemplo de un documento LaTeX y el resultado que se obtiene tras procesarlo.

\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[spanish]{babel}
\begin{document}
\author{Rupertino Gonzales}
\title{Algunas posibilidades de LaTeX}
\maketitle

\section{Elementos}
Puede estructurar el documento en capítulos, secciones, etc.
Este texto es el contenido de la primera sección de este ejemplo,
puede escribir cada párrafo en líneas consecutivas.

\subsection{Ayudas}
Puede lograr efectos como \emph{Itálicas}, \textbf{negrillas} o
cambios en el \textsf{tipo o {\small tamaño} de letra} (note
como se anidaron ambientes en este ejemplo).

Puede crear listas:
\begin{itemize}
\item Primer elemento de lista.
\item Segundo elemento de lista.
\end{itemize}
o tablas
\\
\begin{tabular}{|l|r|} \hline
Título 1 & Título 2 \\\hline
elemento 1 & elemento 2 \\\hline
\end{tabular}
\subsection{Ecuaciones}
LaTeX es un experto en esta materia:
\[ \int_{x=-\infty}^{\infty}e^{-|x|} \]
\end{document}

LaTeX ofrece plantillas para varios tipos de documentos: artículo, reporte, libro y ofrece el concepto de ambiente para indicar como presentar cierta información de acuerdo a la plantilla. En el ejemplo presentado, el tipo de documento es artículo (lo indica la línea documentclass{article}), y uno de los ambientes empleados es tabular, que genera una tabla.

Una vez edite un documento puede procesarlo con LaTeX para obtener un archivo DVI, por ejemplo para generar el archivo documento.dvi a partir de documento.tex:

    latex documento.tex

latex Programa que convierte un archivo LaTeX a DVI.

xdvi Programa para ver un archivo DVI en pantalla.

El archivo DVI es apropiado para imprimir, puede imprimirlo con una orden como dvilj, dvidj o un nombre análogo que corresponda a su impresora ^[10]. Para visualizar un archivo DVI puede emplear la orden xdvi:

    xdvi documento.dvi

dvi2ps Programa para convertir un DVI en PostScript.

y para convertirlo a PostScript puede emplear dvi2ps:

    dvi2ps -c documento.ps documento.dvi

A continuación se presenta como se ve el ejemplo de esta sección con el programa xdvi.

Figura 2. Visualización de DVI generado de fuente en LaTeX

Existen además otros programas para convertir de LaTeX a HTML como latex2html y HeVeA. Puede encontrar más información de latex2html en http://ctan.tug.org/ctan/tex-archive/support/latex2html/ y de HeVeA en http://pauillac.inria.fr/hevea/.

Instale los paquetes openjade, docbook y docbook-dsssl:

        doas pkg_add $PKG_PATH/docbook-4.5p4.tgz
        doas pkg_add $PKG_PATH/docbook-dsssl-1.79p0.tgz
        doas pkg_add $PKG_PATH/openjade-1.3.3pre1p10.tgz

Esto bastará para hacer conversiones de DocBook SGML a HTML por ejemplo si su hoja de estilo DSSL es “marcos.dsl” y va a convertir el documento DocBook marcos.xml:

        openjade  -t sgml -ihtml -d marcos.dsl#html marcos.xml

Para convertir a PostScript además de los paquetes anteriores requiere el paquete texlive (ver TeX y Ghostview) y el paquete jadetex

Como parte del paquete `se instalará el DTD de DocBook XML 4.4 en el directorio/usr/local/share/xml/docbook. Es recomendable que cree el archivo/usr/local/share/xml/catalog` inicialmente con:

        CATALOG "docbook/catalog"

y que agregue en este archivo la ruta de otros catálogos XML o de DTDs.

Para transformar documentos XML con hojas de estilo XSL puede emplear un procesador como xsltproc, que está incluido en el paquete libxslt. Esta herramienta recibe el nombre del archivo XSL y el nombre del archivo XML por transformar. También puede recibir la opción --catalogs que indica usar los catálogos de la variable SGML_CATALOG_FILES (se separan unos catálogos de otros con el carácter “:”), o la opción --nonet que indica no descargar DTDs de Internet (los catálogos deben resolver todos los identificadores públicos).

Las hojas de estilo XSL para transformar DocBook XML en HTML y en XML-FO (Formatting objects, apropiado para imprimir con un procesador FO) se instalan con el paquete `y quedan en/usr/local/share/xsl/docbook`.

Una vez instalados todas las partes puede procesar el archivo ejemplo.xdbk:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"  "/usr/local/share/xml/docbook/4.4/docbookx.dtd" >

    <article lang="es">
        <title>articulo</title>
      <articleinfo>
        <authorgroup>
          <author>
        <firstname>Nombres</firstname>
        <surname>Apellidos</surname>
        <authorblurb>
              <para><address>
              <email>micorreo@pasosdeJesus.org</email>
               </address></para>
        </authorblurb>
          </author>
        </authorgroup>

        <abstract>
            <para>Resumen</para>
        </abstract>

        <legalnotice>
            <para>nota legal</para>
        </legalnotice>

      </articleinfo>

      <sect1 id="s1">
        <title>Primera sección</title>

        <para>Parrafo</para>
      </sect1>
    </article>

con una hoja XSLT de DocBook con:

        export SGML_CATALOG_FILES="/usr/local/share/xml/catalog"
        xsltproc --catalogs --nonet /usr/local/share/xsl/docbook/html/chunk.xsl ejemplo.xdbk

Puede corregir interactivamente la ortografía de un texto plano (digamos carta.txt) usando el diccionario por defecto con:

        ispell carta.txt

o si desea emplear el diccionario de un idioma particular:

        ispell -d spanish carta.txt

Al corregir interactivamente ispell mostrará palabras que no encuentre en el diccionario del idioma ni en su diccionario personal^[11] del idioma (e.g. ~/.ispell_spanish), así como posibles remplazos. Podrá elegir uno de los remplazos tecleando el número que antecede al remplazo.

mplayer es un reproductor de audio y vídeo que soporta gran variedad de formatos. Por ejemplo para ver video.flv:

    mplayer video.flv

Se distribuye con codecs de código abierto y de calidad para muchos formatos.

También permite hacer conversiones y extraer partes. Por ejemplo para extraer pista de audio de un video descargado de youtube, y dejarla en formato WAV:

        mplayer -vo null -ao "pcm:file=pista.wav" -af resample=44100 "video.flv"

Para reproducir 10 segundos de un DVD comenzando en el segundo 240:

        mplayer -ss 240 -endpos 10 dvd://1

Se distribuye junto con mencoder que permite convertir de un formato a otro.

Si requiere una interfaz gráfica de usuario (GUI) puede instalar bien el paquete smplayer o bien gnome-player.

Además de reproducir videos de diversos formatos, permite convertir e incluso transmitir por streaming empleando como fuente un archivo, o un stream desde una red o un dispositivo de captura.

En su forma de uso más simple para ver el video video.mp4:

    vlc video.mp4

El paquete ImageMagick-6.9.12.96 incluye varios programas que le permiten ver una imagen, información de la misma, hacer algunas operaciones o convertir de un formato a otro.

Para ver una gráfica (sin editarla) prácticamente en cualquier formato, puede usar display

    display migrafica.png

Para ver información de una imágen use:

    identify migrafica.png

Para convertir de un formato a otro (y opcionalmente hacerle transformaciones) use:

    convert migrafica.png migrafica.jpg

Para capturar una ventana o una porción rectangular puede usar

    import pantallazo.png

y elegir una ventana o marcar el rectángulo por capturar.

Para enviar correos mutt corre por defecto el programa sendmail (por defecto con parámetros: sendmail -oem -oi), si usted prefiere o necesita emplear el sendmail de otro computador puede:

        #!/bin/sh
        # envia.sh Dominio público

        if (test "$SSH_AUTH_SOCK" = "") then {
            echo "Usar con ssh-agent";
            exit 2;
        } fi;

        cat - | ssh pablo@amor.miescuela.edu.co /usr/sbin/sendmail -oem -oi

Note que este script está hecho para ser ejecutado junto con el
agente de autenticación de ssh (i.e `ssh-agent`).

            set sendmail=/home/pablo/scripts/envia.sh

            ssh-agent /bin/ksh
            ssh-add
            mutt

o si emplea XWindow es posible que pueda configurar su manejador de
escritorio o su administrador de ventanas para que toda la sesión
emplee el agente (ver un ejemplo en [xref](#fluxbox)).

Asegúrese de tener instalados los paquetes ruby-3.3.1 y node-18.19.1p0v0, incluidos en el instalador de adJ 7.5

Asegúrese de tener enlaces al intérprete de ruby y herramientas (como describe el paquete ruby):

    doas sh
    ln -sf /usr/local/bin/ruby33 /usr/local/bin/ruby
    ln -sf /usr/local/bin/bundle33 /usr/local/bin/bundle
    ln -sf /usr/local/bin/bundler33 /usr/local/bin/bundler
    ln -sf /usr/local/bin/erb33 /usr/local/bin/erb
    ln -sf /usr/local/bin/gem33 /usr/local/bin/gem
    ln -sf /usr/local/bin/irb33 /usr/local/bin/irb
    ln -sf /usr/local/bin/racc33 /usr/local/bin/racc
    ln -sf /usr/local/bin/rake33 /usr/local/bin/rake
    ln -sf /usr/local/bin/rbs33 /usr/local/bin/rbs
    ln -sf /usr/local/bin/rdbg33 /usr/local/bin/rdbg
    ln -sf /usr/local/bin/rdoc33 /usr/local/bin/rdoc
    ln -sf /usr/local/bin/ri33 /usr/local/bin/ri
    ln -sf /usr/local/bin/typeprof33 /usr/local/bin/typeprof

    kern.shminfo.shmmni=1024
    kern.seminfo.semmns=2048
    kern.shminfo.shmmax=50331648
    kern.shminfo.shmall=51200
    kern.maxfiles=20000

    staff:\
            :datasize-cur=1536M:\
            :datasize-max=infinity:\
            :maxproc-max=4096:\
            :maxproc-cur=4096:\
            :openfiles-max=8090:\
            :openfiles-cur=8090:\
            :ignorenologin:\
            :requirehome@:\
            :tc=default:

    # Configuración de irb
    # Basado en archivo de órdenes disponible en <http://girliemangalo.wordpress.com/2009/02/20/using-irbrc-file-to-configure-your-irb/>
    require 'irb/completion'
    require 'pp'
    IRB.conf[:AUTO_INDENT] = true
    IRB.conf[:USE_READLINE] = true

    def clear
        system('clear')
    end

    doas mkdir -p /var/www/bundler/ruby/3.3/
    doas chown -R $USER:www /var/www/bundler

    gem install --install-dir /var/www/bundler/ruby/3.3/ json

    doas gem install --install-dir /var/www/bundler/ruby/3.3/ bcrypt

    doas gem install pkg-config

    doas gem install bundler
    if (test -x /usr/local/bin/bundle33) then {
       doas ln -sf /usr/local/bin/bundle33 /usr/local/bin/bundle;
    } fi

  bundle config path /var/www/bundler/

---
BUNDLE_PATH: "/var/www/bundler/"

    mkdir .bundle
    cat > .bundle/config <<EOF
    ---
    BUNDLE_PATH: "/var/www/bundler"
    BUNDLE_DISABLE_SHARED_GEMS: "true"
    EOF

    bundle install

    doas gem install --install-dir /var/www/bundler/ruby/3.3 json

    bundle pristine

    doas gem install --install-dir /var/www/bundler/ruby/3.3 nokogiri -v '2.0'

    doas gem install rails

        doas gem install --install-dir /var/www/bundler/ruby/3.3/ nokogiri -- --use-system-libraries

        QMAKE=qmake-qt5 MAKE=gmake doas gem install capybara-webkit

doas npm install -g yarn

/tmp/yarn--1602506143839-0.91595986516731/node[3]:
/tmp/yarn--1602506143839-0.91595986516731/../node: not found

doas ln -s /usr/local/bin/node /tmp/

    cd ~
    mkdir -p .vim
    cd .vim
    cp -rf /usr/local/share/vim/vim91/* .

    cp /usr/local/share/vim/vim91/vimrc_example.vim ~/.vimrc

    setlocal shiftwidth=2
    setlocal tabstop=2
    set expandtab

Para aprender lo básico de Ruby puede comenzar con el tutorial en español disponible en http://rubytutorial.wikidot.com/

Puede aprender por ejemplo con los tutoriales interactivos de https://rubymonk.com

En Internet puede ver la referencia oficial de las clases en: http://ruby-doc.org/core-3.3.0/Integer.html

Y es buena referencia para Ruby, Rails y Rspec (incluidos cambios entre una versión y otra y comentarios) es: http://apidock.com/

Podrá consultar documentación del núcleo, librería estándar y gemas instalando el paquete ruby-ri_docs y ejecutando ri seguido de la clase (por ejemplo ri Float) o sin parámetro ingresa a una consola que da la posibilidad de autocompletar presionando Tab (por ejemplo pruebe tecleando Float y después Tab dos veces).

También podrá ver la documentación de las gemas en formato Rdoc ejecutando:

    gem server

y con un navegador consultando http://localhost:8808

Las versiones anteriores a la 1.7, deben compilarse como portes (de subdirectorios de /usr/ports/devel/jdk/), pues las licencias de las fuente exigen que al descargar de las mismas las haga directamente de los sitios de distribución. Al intentar compilar cada uno podrá ver instrucciones que le indican de donde descargar las fuentes para ubicarlas en /usr/ports/distfiles.

Tras descargar manualmente las fuentes, la compilación e instalación son directas (i.e con make y make install respectivamente).

Si por ejemplo instala jdk-1.4 los binarios quedarán en /usr/local/jdk1.4/bin/ así que es recomendable que agregue tal ruta a su variable PATH por ejemplo en su archivo ~/.profile o el equivalente.

El jdk-1.4 incluye un plugin que puede emplearse con mozilla o mozilla-firefox. Basta ejecutar:

    cd  ~/.mozilla
    mkdir plugins
    cd plugins
    ln -s /usr/local/jdk-1.4.2/jre/plugin/i386/ns610/libjavaplugin_oji.so .

después reiniciar mozilla-firefox y verificar que el plugin esté operando abriendo el URL about:plugins. Como se indica en http://archives.neohapsis.com/archives/openbsd/2005-09/2253.html, para que puedan cargarse applets es necesario aumentar el límite de memoria para datos con algo como:

    ulimit -d 2000000

que de requerirse puede ejecutarse desde la cuenta root (cuyo límite máximo es mayor que el de cuentas de usuario).

toncli es un paquete de python que facilita el desarrollo y pruebas de contratos inteligentes para el blockchain TON.

Como en el diseño de la TVM original no se incluyeron muchas ayudas para el desarrollo o para la depuración, para emplear toncli debe usar una bifurcación de la TVM original con más instrucciones para depurar: https://github.com/SpyCheese/ton/tree/toncli-local

adJ también incluye un paquete con esa bifurcación llamado ton-toncli cuyos archivos son como los del paquete ton pero en rutas diferentes (i.e /usr/local/bin/ton-toncli, /usr/local/lib/ton-toncli y /usr/local/share/ton-toncli/).

Una vez tenga instalado el paquete ton-toncli, instale toncli así:

doas pkg_add py3-pip
doas pip install bitstring==3.1.9   
doas pip install toncli

Tras esto, debe poder ejecutar:

toncli

Que en la primera ejecución le pedirá:

Esas rutas quedarán en el archivo ~/.config/toncli/config.ini

6.8.1.2.1. Ejemplo de un contrato y sus pruebas con toncli 0.0.43

Como ejemplo implementaremos un contrato inteligente que calcule el máximo común divisor entre dos números (ejercicio propuesto en la segunda competencia de programación en FunC como puede verse en https://github.com/ton-blockchain/func-contest2).

Desde la terminal podrá preparar una estructura de directorios con:

toncli start wallet        # Inicia proyecto con ejemplo de una billetera
mv wallet pruebas_mdc_func # Renombra
cd pruebas_mdc_func
find .

Verá la estructura de un proyecto toncli típico que incluye:

.
├── build              Aquí quedarán resultados de compilación
├── fift               Directorio con fuentes en fift (por borrar en este caso)
├── func               Directorio con fuentes en FunC
│   └── code.func      Código con la función por probar
├── project.yaml       Estructura del proyecto para toncli
└── tests              Directorio con fuentes en FunC de pruebas de regresión

Podemos reorganizar un poco el proyecto de ejemplo para nuestro caso de una sola función en FunC con:

rm -rf fift                        # no necesitamos ejemplo en fift
mv func/code.func func/solucion.fc # La extensión .fc es bastante usada

Editar project.yaml para que quede el siguiente contenido que indica que el código FunC por probar está en func/solucion.fc y las pruebas están en tests/pruebas.fc :

contract:
  func:
      - func/solucion.fc
  tests:
      - tests/pruebas.fc

El contenido de func/solucion.fc:

{-
  TAREA 1 - Máximo divisor común

  Enunciando basado en:
  https://github.com/vtamara/func-contest2/blob/master/1.fc

  Escribir un método que calcule el máximo divisor común entre 2 enteros
  mayores o iguales a 1 y menores que 1048576.
-}

() recv_internal() {
}

;; por probar
(int) gcd(int a, int b) method_id {

  ;; Solución con base en
  ;; https://people.cs.ksu.edu/~schmidt/301s14/Exercises/euclid_alg.html
  int k = a;
  int m = b;
  if (b > a) {
    k = b;
    m = a;
  }
  ;; k es max(a,b) y m = min(a,b)

  while (m != 0) {
    int r = k % m;
    k = m;
    m = r;
  }

  return k;
}

Y como contenido de tests/pruebas.fc:

int __test_t30_12() {

  int a = 30;
  int b = 12;

  tuple pila = unsafe_tuple([a, b]);

  cell datos = begin_cell().end_cell();

  var (int gas_usado1, pila_ret) = invoke_method(gcd, pila);

  int result = first(pila_ret);

  throw_if(101, result != 6);  ;; mcd(30, 12) == 6

  return gas_usado1;
}

Tras esto ya podrá ejecutar las pruebas con:

toncli run_tests

o más simple

make

una vez cree un archivo Makefile con el siguiente contenido:

all:
        toncli run_tests

Que deben darle un resultado como el del pantallazo siguiente:

Figura 3. Pantallazo con ejecución exitosa de toncli