Commit 6f0f782e authored by Georges Khaznadar's avatar Georges Khaznadar

New upstream version 4.4.1+dfsg

parent 00682ade

Too many changes to show.

To preserve performance only 1000 of 1000+ files are displayed.

......@@ -10,9 +10,6 @@ build/
# lyx generated files
*-lyxformat-*.lyx
# sphinx generated files
_build/
# debian packaging temporaries
debian/*.log
debian/*.substvars
......
# udev rules for expEYES interface: AVR, FT232 and MCP2200
ATTR{idVendor}=="03eb", ATTR{idProduct}=="21ff", MODE="666"
ATTR{idVendor}=="0403", ATTR{idProduct}=="6001", MODE="666"
ATTR{idVendor}=="04d8", ATTR{idProduct}=="00df", MODE="666"
# udev rules for expEYES interface: AVR, FT232, MCP2200 and CH340
SUBSYSTEM=="usb",ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="21ff", MODE="666"
SUBSYSTEM=="tty",ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="666"
SUBSYSTEM=="tty",ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="00df", MODE="666"
SUBSYSTEM=="tty",ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", MODE="666"
ATTRS{idVendor}=="03eb", ATTRS{idProduct}=="21ff", ENV{ID_MM_DEVICE_IGNORE}="1"
ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", ENV{ID_MM_DEVICE_IGNORE}="1"
ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="00df", ENV{ID_MM_DEVICE_IGNORE}="1"
ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", ENV{ID_MM_DEVICE_IGNORE}="1"
DESTDIR =
LANGUAGES = $(shell find . -type d -mindepth 1 -maxdepth 1 | grep -Ev 'pics|schematics' | tr -d './')
RST_SUBDIRS = $(shell ls -d */rst)
all:
for d in $(RST_SUBDIRS); do make -C $$d; done
clean:
for d in $(RST_SUBDIRS); do make -C $$d distclean; done
install:
for l in $(LANGUAGES); do \
install -d $(DESTDIR)/usr/share/eyes17/rst/$$l; \
install -d $(DESTDIR)/usr/share/eyes17/doc/$$l; \
install -m 755 $$l/rst/exp/_build/latex/eyes17.pdf \
$(DESTDIR)/usr/share/eyes17/doc/$$l; \
cp -a $$l/rst/qt5HTML/* $(DESTDIR)/usr/share/eyes17/rst/$$l; \
done
# The User Manual for EYES17 #
This user manual is built from RST files, which were extracted from
??/eyes17-a4.lyx with the help of elyxer, pandoc, a few small scripts,
and some handwork.
Now, the RST (ReStructured Text) files can be used to build eyes-17's
user manual in various formats:
1. styled HTML
2. PDF with a cover and a preamble
3. EPUB3, which is well rendered with Calibre
4. plain HTML, which is used by the UI of Eyes17, for help purpose.
The User Manual exists in a few languages, like en, fr. The directories
with the language names contain the sources and the files built from them.
## Building the User Manual and help files ##
Here are a few recommendations to manage the sources and build the manual.
### Build-dependencies ###
For a Debian-like distribution, here is a list of necessary packages:
* `python3-sphinx`,
* `librsvg2-bin`,
* `imagemagick`,
* `dvipng`,
* `latexmk`,
* `texlive-latex-recommended`,
* `texlive-fonts-recommended`,
* `texlive-latex-extra`,
* and of course, ordinary packages like `make`.
### To reset all built files ###
> `cd $lang/rst; make distclean`
### To rebuild/update the files ###
> `cd $lang/rst; make all`
## Where are the results? ##
After a successful build, here are the files locations:
1. styled HTML
in `$lang/rst/exp/_build/html/index.htm` and other files of
the directory `$lang/rst/exp/_build/html/`; all files in that directory
are useful.
2. PDF with a cover and a preamble
in `$lang/rst/exp/_build/latex/eyes17.pdf`, which is a standalone file.
3. EPUB3, which is well rendered with Calibre
in `$lang/rst/exp/_build/epub/eyes17.epub`, which is a standalone file.
4. plain HTML, which is used by the UI of Eyes17, for help purpose,
in `$lang/rst/qt5HTML/*`; all files in that directory are useful.
# Making a new translation for the User Manual of EYES17 #
Here is a recipe, which can be improved later:
Let 'xy' be this new language
(for example, 'xy' can be 'es', 'nl', and so on)
1. copy recursively a language directory to the new one, for example:
`cp -a en xy`
2. do the same thing for translated schematics, for example:
`cp -a schematics/en schematics/xy`
3. edit the file `xy/rst/exp/conf.py`, to change the default language,
for example, the line containing `language = 'en'` should be changed to
`language = 'xy'`
4. open the files `*.rst` which are in the directory `xy/rst/exp/` and edit
their contents to translate them to your language.
5. open the files `*.svg` which are in the directory `schematics/xy/` with
a good SVG editor, like Inkscape, and edit
their contents to translate them to your language.
6. launch `cd $lang/rst; make all`; that's all.
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: ffd74843cae34b30eb4e0732cad1ca06
tags: 490e2b0d4a1bebf665648774830bc9b4
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops">
<head>
<meta charset="utf-8" />
<title>Introduction</title>
<link rel="stylesheet" href="_static/epub.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
</head><body>
<div class="document">
<div class="documentwrapper">
<div class="body" role="main">
<div class="section" id="introduction">
<h1>Introduction</h1>
<p>Science is the study of the physical world by systematic observations
and experiments. Proper science education is essential for cultivating a
society where reasoning and logical thinking prevails and not
superstition and irrational beliefs. Science education is also es