Skip to content

Commit bc25c50

Browse files
jamescrjamescr
authored
Merge pull request #134 from LabExperimental-SIUA/develop
New version 1.1.0
2 parents 387309b + fe66fba commit bc25c50

20 files changed

Lines changed: 194 additions & 118 deletions

‎README.md‎

Lines changed: 79 additions & 117 deletions
Original file line numberDiff line numberDiff line change
@@ -1,144 +1,106 @@
11
# LibreScan
22

3-
LibreScan es un proyecto de Software Libre desarrollado en el Laboratorio Experimental del Centro Académico de Alajuela, sede del Instituto Tecnológico de Costa Rica. Este proyecto de investigación consiste en la elaboración de un software que agrupa distintas herramientas que cumplen funciones específicas dentro del flujo de tareas necesarias para escanear un documento. El objetivo de LibreScan es promover el acceso libre al conocimento y la educación, al proveer un software libre y gratuito que permita realizar el proceso de captura de fotos, procesamiento y generación de un documento digital.
3+
- Instalar dependencias que serán utilizadas:
44

5-
## Instalación
5+
# apt-get install python3-pip lua5.2 liblua5.2 git-svn libusb-dev python3 python-dev libjpeg8 libffi-dev libturbojpeg1-dev
66

7-
Actualmente el software funciona en el sistema operativo Debian 8 Jessie. Existen dos formas de instalar LibreScan:
7+
# pip3 install pyYAML bottle pyjade jinja2 polib cffi pexpect
88

9-
1. Forma resumida:
9+
# pip3 install jpegtran-cffi==0.5.2
1010

11-
- Clonar este repositorio:
12-
13-
$ git clone https://github.com/LabExperimental-SIUA/LibreScan.git
14-
15-
- Entrar en la carpeta clonada:
16-
17-
$ cd LibreScan
18-
19-
- Como root, sobreescribir el sources.list del sistema operativo
20-
21-
# cp apt.sources /etc/apt/sources.list
22-
23-
- Actualizar lista de paquetes de los repositorios:
24-
25-
# apt-get update
26-
27-
- Dar permisos de ejecución al script Dependencies.sh:
28-
29-
# chmod +x Dependencies.sh
30-
31-
- Ejecutar el script de instalación de dependencias:
32-
33-
# sh Dependencies.sh
3411
--------------------------------------------------------------------------------------------
3512

36-
2. Forma manual:
13+
- Instalar tesseract-ocr para el reconocimiento de texto:
3714

38-
- Instalar dependencias que serán utilizadas:
39-
40-
# apt-get install python3-pip lua5.2 liblua5.2 git-svn libusb-dev python3 python-dev libffi-dev libturbojpeg1-dev libssl-dev libjpeg8-dev libjpeg8
41-
42-
# pip3 install pyYAML bottle pyjade jinja2 polib cffi pexpect
43-
44-
# pip3 install jpegtran-cffi==0.5.2
45-
46-
--------------------------------------------------------------------------------------------
47-
48-
- Instalar tesseract-ocr para el reconocimiento de texto:
49-
50-
# apt-get install tesseract-ocr
51-
52-
Nota: Para más idiomas se instala de esta forma (Ejemplo con español):
53-
54-
# apt-get install tesseract-ocr-spa (Para Español)
55-
56-
--------------------------------------------------------------------------------------------
57-
58-
- Instalar scantailor para el procesamiento de las fotos:
59-
60-
# apt-get install scantailor
61-
62-
Posteriormente hacer un # apt-get update
63-
64-
--------------------------------------------------------------------------------------------
65-
66-
- Instalar pdfbeads para generar pdfs a partir de tifs+hocr:
67-
68-
# apt-get install ruby ruby-dev ruby-rmagick
69-
# gem install iconv pdfbeads
70-
71-
72-
--------------------------------------------------------------------------------------------
73-
- En cuanto a las cámaras hay que instalar el CHDKPTP en el sistema.
74-
75-
$ git svn clone http://subversion.assembla.com/svn/chdkptp/trunk chdkptp
76-
77-
$ cd chdkptp
78-
79-
-- nota: al 01.02.2015 Checked out HEAD:
80-
http://subversion.assembla.com/svn/chdkptp/trunk r694
81-
82-
$ mv config-sample-linux.mk config.mk
83-
84-
$ make
85-
86-
# mkdir /usr/bin/chdkptp
87-
88-
# cp chdkptp-sample.sh /usr/bin/chdkptp/chdkptp
89-
90-
-- nota: chdkptp-sample.sh está en la dirección donde se descargó el chdkptp.
91-
92-
# nano /usr/bin/chdkptp/chdkptp
93-
94-
Modificar la línea que dice
95-
96-
#CHDKPTP_DIR=/path/to/chdkptp
97-
98-
por:
99-
100-
CHDKPTP_DIR=<FolderClonado>/chdkptp (Y guardamos los cambios)
101-
102-
nota: <FolderClonado>/chdkptp es la dirección donde se haya clonado el chdkptp (en el primer paso de esta sección).
103-
104-
# ln -s /usr/bin/chdkptp/chdkptp /bin
105-
106-
--------------------------------------------------------------------------------------------
107-
- Es necesario tener CHDK instalado en las cámaras. (En caso de no tenerlo se puede seguir esta guía. Se recomienda usar el método "a"):
108-
https://github.com/LabExperimental-SIUA/ilt/wiki/Instalaci%C3%B3n-de-CHDK
109-
110-
111-
112-
113-
- Para reconocer cuál cámara es la derecha y cuál es la izquierda hacemos uso de un archivo 'orientation.txt', que se encuentra almacenado la raíz de la tarjeta SD de cada cámara. Por ahora este proceso se debe hacer manualmente, introduciendo la SD en la computadora y creando el archivo manualmente. Pasos:
114-
115-
1. Asegurarse que la SD esté desbloqueada.
116-
2. Para la cámara que desea usar al lado izquierdo, crear un archivo orientation.txt que tenga la palabra 'left' (sin comillas) como contenido.
117-
3. Para la cámara que desea usar al lado derecho, crear un archivo orientation.txt que tenga la palabra 'right' (sin comillas) como contenido.
15+
# apt-get install tesseract-ocr
16+
17+
Nota: Para más idiomas se instala de esta forma (Ejemplo con español):
18+
19+
# apt-get install tesseract-ocr-spa (Para Español)
20+
21+
--------------------------------------------------------------------------------------------
22+
23+
- Instalar scantailor para el procesamiento de las fotos:
24+
25+
# apt-get install scantailor
11826

119-
Nota: Estamos trabajando en automatizar este proceso, de modo que se el usuario conecte las cámaras y decida la orientación sin crear el archivo manualmente.
27+
Nota: Si no se encuentra en los repositorios agregar este a /etc/apt/sources.list:
28+
29+
- deb http://http.debian.net/debian wheezy-backports main
30+
31+
Posteriormente hacer un # apt-get update
32+
33+
--------------------------------------------------------------------------------------------
34+
35+
- Instalar pdfbeads para generar pdfs a partir de tifs+hocr:
36+
37+
# apt-get install ruby ruby-dev ruby-rmagick
38+
# gem install iconv pdfbeads
39+
40+
41+
--------------------------------------------------------------------------------------------
42+
- En cuanto a las cámaras hay que instalar el CHDKPTP en el sistema.
43+
44+
$ git svn clone http://subversion.assembla.com/svn/chdkptp/trunk chdkptp
45+
46+
$ cd chdkptp
47+
48+
-- nota: al 01.02.2015 Checked out HEAD:
49+
http://subversion.assembla.com/svn/chdkptp/trunk r694
50+
51+
$ mv config-sample-linux.mk config.mk
52+
53+
$ make
54+
55+
# mkdir /usr/bin/chdkptp
56+
57+
# cp chdkptp-sample.sh /usr/bin/chdkptp/chdkptp
58+
59+
-- nota: chdkptp-sample.sh está en la dirección donde se descargó el chdkptp.
60+
61+
# nano /usr/bin/chdkptp/chdkptp
62+
63+
Modificar la línea que dice
64+
65+
#CHDKPTP_DIR=/path/to/chdkptp
66+
67+
por:
12068

121-
- Clonar el repositorio:
69+
CHDKPTP_DIR=<FolderClonado>/chdkptp (Y guardamos los cambios)
70+
71+
nota: <FolderClonado>/chdkptp es la dirección donde se haya clonado el chdkptp (en el primer paso de esta sección).
72+
73+
# ln -s /usr/bin/chdkptp/chdkptp /bin
74+
75+
--------------------------------------------------------------------------------------------
76+
- Es necesario tener CHDK instalado en las cámaras. (En caso de no tenerlo se puede seguir esta guía. Se recomienda usar el método "a"):
77+
https://github.com/LabExperimental-SIUA/ilt/wiki/Instalaci%C3%B3n-de-CHDK
78+
79+
- Para reconocer cuál cámara es la derecha y cuál es la izquierda hacemos uso de un archivo 'orientation.txt', que se encuentra almacenado la raíz de la tarjeta SD de cada cámara. Por ahora este proceso se debe hacer manualmente, introduciendo la SD en la computadora y creando el archivo manualmente. Pasos:
12280

123-
$ git clone https://github.com/LabExperimental-SIUA/LibreScan.git
81+
1. Asegurarse que la SD esté desbloqueada.
82+
2. Para la cámara que desea usar al lado izquierdo, crear un archivo orientation.txt que tenga la palabra 'left' (sin comillas) como contenido.
83+
3. Para la cámara que desea usar al lado derecho, crear un archivo orientation.txt que tenga la palabra 'right' (sin comillas) como contenido.
84+
85+
86+
87+
Nota: Estamos trabajando en automatizar este proceso, de modo que se el usuario conecte las cámaras y decida la orientación sin crear el archivo manualmente.
12488

12589
--------------------------------------------------------------------------------------------
126-
## Configuración y Uso
90+
- Una vez instaladas todas las dependencias, procedemos a clonar el repositorio de LibreScan.
91+
92+
$ git clone https://github.com/LabExperimental-SIUA/LibreScan.git
12793

128-
- Ingresamos al código fuente del repositorio clonado:
94+
- Nos metemos a la carpeta clonada, y al código fuente.
12995

13096
$ cd LibreScan/src
13197

13298
- Corremos el setup para la creación de carpetas y archivos de configuración.
13399

134100
$ python3.4 setup.py
135101
136-
137-
**NOTA: los pasos anteriores solo deben ser ejecutados una vez.**
138-
139102
- Para ejecutar la aplicación web
140103

141104
$ python3.4 main.py web
142105

143106
- Por último, abrimos el navegador en http://0.0.0.0:8180
144-

‎bin/librescan.sh‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
#!/bin/bash
2+
3+
# Kill all other running instances
4+
kill `ps aux | grep main.py | grep -v 'grep' | awk '{print $2}' | xargs`
5+
6+
# Se pasa al directorio de LibreScan
7+
cd /usr/share/LibreScan/src/
8+
9+
#check if running the setup is necesary
10+
if [ ! -d $HOME/.librescan/ ]
11+
then
12+
python3 setup.py
13+
fi;
14+
15+
# Run the application
16+
python3 main.py web

‎debian/.changelog.swp‎

12 KB
Binary file not shown.

‎debian/changelog‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
librescan (1.1.0-0) stable; urgency=low
2+
3+
* Bug fix
4+
5+
-- Equipo LibreScan <librescan@gmail.com> Fri, 09 Dec 2016 07:56:34 -0600
6+
7+
librescan (1.0.0-0) stable; urgency=low
8+
9+
* Initial release
10+
11+
-- Equipo LibreScan <librescan@gmail.com> Fri, 09 Jul 2016 07:56:34 -0600

‎debian/compat‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
9

‎debian/control‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Source: librescan
2+
Section: text
3+
Priority: optional
4+
Maintainer: Laboratorio Experimental ITCR <librescan@gmail.com>
5+
Build-Depends: debhelper (>=9)
6+
Standards-Version: 3.9.6
7+
Homepage: http://labexperimental-siua.github.io/LibreScan/
8+
9+
Package: librescan
10+
Architecture: all
11+
Depends: python3-pip, lua5.2, liblua5.2-0, git-svn, libusb-dev, python3, python-dev, libturbojpeg1, libjpeg62, libjpeg62-turbo-dev, libssl-dev, libffi-dev, tesseract-ocr, tesseract-ocr-spa, scantailor, ruby, ruby-dev, ruby-rmagick, libyaml-dev, libturbojpeg1-dev, chdkptp
12+
Description: Herramienta para digitalización de textos impresos
13+
LibreScan es un proyecto de Software Libre desarrollado en el Laboratorio Experimental del Centro Académico de Alajuela, sede del Instituto Tecnológico de Costa Rica cuyo objetivo es promover el acceso libre al conocimento y la educación, al proveer un software libre y gratuito que permita realizar el proceso de captura de fotos, procesamiento y generación de un documento digital. Este paquete provee las herramientas para facilitar el trabajo con los escáneres desarrollados por el proyecto "DIY Book Scanner", quienes desarrollan y elaboran de escáneres artesanales de bajo costo.

‎debian/copyright‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
2+
Name: librescan
3+
Source: http://labexperimental-siua.github.io/LibreScan/
4+
Mantainer: Laboratorio Experimental <librescan@gmail.com>
5+
6+
Files: *
7+
Copyright: 2015-2017 Laboratorio experimental
8+
License: GPLv3
9+
This program is free software: you can redistribute it and/or modify
10+
it under the terms of the GNU General Public License as published by
11+
the Free Software Foundation, either version 3 of the License, or
12+
(at your option) any later version.
13+
.
14+
This program is distributed in the hope that it will be useful,
15+
but WITHOUT ANY WARRANTY; without even the implied warranty of
16+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17+
GNU General Public License for more details.
18+
.
19+
You should have received a copy of the GNU General Public License
20+
along with this program. If not, see <http://www.gnu.org/licenses/>.
21+

‎debian/debhelper-build-stamp‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
librescan

‎debian/files‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
librescan_1.1.0-0_all.deb text optional
2+
librescan_1.1.0-0_amd64.buildinfo text optional

‎debian/install‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
LibreScan /usr/share/

0 commit comments

Comments
 (0)