Overview

HTTPS SSH
ToolboX V1.0 (beta)
===================

## INSTALACIÓN

Requiere

  - distro Ubuntu 16.04 / Lubuntu 16.04* / Debian Stretch
  - octave (>=4.0)
  - liboctave-dev (>=4.0.0)
  - make (>=4.1-6)
  - geany (>=1.27-1)
  - geany-plugin-py (>= 1.27+dfsg-2)
  - python (>= 2.7.11-1)
  - python-gtk2 (>= 2.24.0-4ubuntu1)
  - utilidades de Latex (pdflatex) y pdftoppm
    texlive-latex-base  (>=2015.20160320-1)
    texlive-extra-utils (>=2015.20160320-1) : pdflatex
    texlive-latex-extra (>=2015.20160320-1) : standalone.cls
    texlive-fonts-recommended (>= 2015.20160320-1ub)
    texlive-lang-korean (>= 2015.20160223-1)
    poppler-utils (>= 0.41.0)
  - mlterm (>=3.5)
  - libsixel-bin (>=1.5.2-2)
  - wmctrl (>=1.07)
  - xautomation (>=1.09-1)
  - mplayer (>= 1.2.1)
  - libcanberra-gtk-module (>= 0.30)
  - xbitmaps (>= 1.1.1-2)
  - gnome-themes-standard (>= 3.18.0)
  - fonts-baekmuk (>= 2.2-11) : install dotum font (Hangul characters)

* http://cdimage.ubuntu.com/lubuntu/releases/16.04/release/lubuntu-16.04.2-desktop-amd64.iso


### Mediante clonado

sudo hg clone https://bitbucket.org/fjvico/toolbox /opt/toolbox


### Mediante fichero deb

Descargar el fichero deb de instalación e instalar:

$ wget --quiet toolbox.uma.es/download/toolbox_latest.deb

$ sudo dpkg -i toolbox_1.0-1.deb
  dpkg: dependency problems prevent ...
  [additional messages]

$ sudo apt-get -f install
  [apt messages]
  Setting up [dependency]...
  Setting up package_with_unsatisfied_dependencies...

Note: By default, ToolboX launcher will be available in the Programming category.
      It can be made available at the Education Category by changing the
      Categories line in the `toolbox.desktop` file, replacing 'Development'
      by 'Education'.
      Other categories are included, like:
        ComputerScience;Math;Physics;Chemistry;Biology;
      since ToolboX can be used in these academic subjects.
      A complete list of categories can be found here:
        https://specifications.freedesktop.org/menu-spec/1.0/apa.html


### Creación de ISO

1. Descargar Lubuntu 16.04
2. Crear Live con persistencia en un pendrive mediante UNetBootin
3. Generar ISO con Systemback / makeusb


## ESTRUCTURA DE DIRECTORIOS

/opt/toolbox/

  .toolboxconfig

  lib/      exe/           toolboxloop
                           texmize ...
            core/          toolbox.m
                           execute.m ...
            board/         makeboard.m ...
            jsonlab/       jsonload.m ...
            latex/         lprintf.m ...
            color/         cprintf.m ...
            topic/         inclinedplane.m
                           pendulum.m ...
            m/             task.m
                           statement.m
                           go.m ...

  addon/    wordproblem/   wordproblem.m
            puzzle/        puzzle.m
                           m/        moveright.m
                                     movedown.m ...
            ...

  util/     install/       toolboxinstall ...
            autostart/
            ...

  content/  es/            task/     00000001
                                     00000002 ...
            en/            task/     00000001
                                     00000002 ...
            ko/            task/     00000001
                                     00000002 ...
            module/        b1m ...
            extra/         toolboxheader.sty
                           toolboxgraphics.sty
                           toolboxformulas.sty ...

~/.toolbox/

  content/  task/          movimientoarmonico ...
            media/         pendulo.png ...
            module/        fisica ...

  util/     geany/         geany.conf
                           keybindings.conf ...


## TIPOS DE FICHEROS

GNU/Octave  Scripts de usuario, con extensión "m".
LaTeX       Definición de macros con extensión "sty".
JSON        Tareas y módulos, sin extensión.
            Incluye caracteres especiales no aceptados en el estándar RFC 7159.
              (el motivo: sin saltos de línea, la definición es ilegible)
python      Scripts para Geany y validar JSON.
texto       Definición de módulos, sin extensión. (Permite comentarios con '#'.)


## CREDITOS

ToolboX ha sido desarrollado por Francisco Vico, en el departamento de
Lenguajes y Ciencias de la Computación, ETS Ingeniería Informática
(Universidad de Málaga).

Para su funcionamiento, depende de software libre. Algunos de estos
programas son GNU Octave, Geany, Openbox, LaTeX, xdotool, lmterm, sixel
y el mismo sistema operativo Linux.

Además, en ToolboX se integran porciones de otros paquetes distribuidos
en código abierto, así como elementos gráficos gratuitos:

- mlterm:    Araki Ken <j00v0113@ip.media.kyoto-u.ac.jp>
- jsonlab:   Qianqian Fang (https://github.com/fangq/jsonlab)
- cprintf.m: ederag <edera@gmx.fr>
- wmctrl:    Tomas Styblo <tripie@cpan.org>
- texmize:   lgeorget (http://unix.stackexchange.com/users/37538/lgeorget)
- iconos:    Icons8 LLC (https://icons8.com)
- sonidos:   SoundBible.com (http://soundbible.com/)

Igualmente, muchas de las funcionalidades de ToolboX han sido posibles
gracias a la colaboración de usuarios de StackExchange (princialmente,
Stack Overflow, Unix & Linux y Ask Ubuntu).


## LICENCIA

ToolboX se distribuye bajo licencia GNU GPLv3.