Published : 2013-02-13 License : None



Documents pareils
Instructions Mozilla Thunderbird Page 1

WEB page builder and server for SCADA applications usable from a WEB navigator

Utiliser une WebCam. Micro-ordinateurs, informations, idées, trucs et astuces

Once the installation is complete, you can delete the temporary Zip files..

DOCUMENTATION - FRANCAIS... 2

Contents Windows

Le passé composé. C'est le passé! Tout ça c'est du passé! That's the past! All that's in the past!

Application Form/ Formulaire de demande

WiFi Security Camera Quick Start Guide. Guide de départ rapide Caméra de surveillance Wi-Fi (P5)

Vanilla : Virtual Box

DOCUMENTATION MODULE BLOCKCATEGORIESCUSTOM Module crée par Prestacrea - Version : 2.0

Quick Start Guide This guide is intended to get you started with Rational ClearCase or Rational ClearCase MultiSite.

Lesson Plan Physical Descriptions. belle vieille grande petite grosse laide mignonne jolie. beau vieux grand petit gros laid mignon

Package Contents. System Requirements. Before You Begin

Instructions pour mettre à jour un HFFv2 v1.x.yy v2.0.00

How to Login to Career Page

Tutoriel de formation SurveyMonkey

DOCUMENTATION - FRANCAIS... 2

that the child(ren) was/were in need of protection under Part III of the Child and Family Services Act, and the court made an order on

GIGABIT PCI DESKTOP ADAPTER DGE-530T. Quick Installation Guide+ Guide d installation+

Dans une agence de location immobilière...

Guide d'installation rapide TFM-560X YO.13

lundi 3 août 2009 Choose your language What is Document Connection for Mac? Communautés Numériques L informatique à la portée du Grand Public

TABLE DES MATIERES A OBJET PROCEDURE DE CONNEXION

Editing and managing Systems engineering processes at Snecma

Micro-ordinateurs, informations, idées, trucs et astuces utiliser le Bureau à distance

Installation UpdatEngine serveur (CentOs apache2 / MySQL)

Préparation d un serveur Apache pour Zend Framework

Gestion des prestations Volontaire

RAPID Prenez le contrôle sur vos données

Notice Technique / Technical Manual

Ocs Inventory et GLPI s appuie sur un serveur LAMP. Je vais donc commencer par installer les paquets nécessaires.

MELTING POTES, LA SECTION INTERNATIONALE DU BELLASSO (Association étudiante de lʼensaparis-belleville) PRESENTE :

RULE 5 - SERVICE OF DOCUMENTS RÈGLE 5 SIGNIFICATION DE DOCUMENTS. Rule 5 / Règle 5

calls.paris-neuroscience.fr Tutoriel pour Candidatures en ligne *** Online Applications Tutorial

AMENDMENT TO BILL 32 AMENDEMENT AU PROJET DE LOI 32

Our recommendation engine has come up with some personalized suggestions for you.

Acce s aux applications informatiques Supply Chain Fournisseurs

Tammy: Something exceptional happened today. I met somebody legendary. Tex: Qui as-tu rencontré? Tex: Who did you meet?

Règlement sur le télémarketing et les centres d'appel. Call Centres Telemarketing Sales Regulation

Comment Accéder à des Bases de Données MySQL avec Windows lorqu'elles sont sur un Serveur Linux

CETTE FOIS CEST DIFFERENT PDF

Nouveautés printemps 2013

Thank you for choosing the Mobile Broadband USB Stick. With your USB Stick, you can access a wireless network at high speed.

ONTARIO Court File Number. Form 17E: Trial Management Conference Brief. Date of trial management conference. Name of party filing this brief

Table des matières. 1. Installation de VMware ESXI Pré-requis Installation... 3

APPENDIX 6 BONUS RING FORMAT

CONVENTION DE STAGE TYPE STANDART TRAINING CONTRACT

Academic Project. B2- Web Development. Resit Project. Version 1.0 Last update: 24/05/2013 Use: Students Author: Samuel CUELLA

SERVEUR DÉDIÉ DOCUMENTATION

If you understand the roles nouns (and their accompanying baggage) play in a sentence...

1.The pronouns me, te, nous, and vous are object pronouns.

DOCUMENTATION - FRANCAIS... 2

THE EVOLUTION OF CONTENT CONSUMPTION ON MOBILE AND TABLETS

Contrôle d'accès Access control. Notice technique / Technical Manual

Compléter le formulaire «Demande de participation» et l envoyer aux bureaux de SGC* à l adresse suivante :

CEST POUR MIEUX PLACER MES PDF

Thank you for choosing the Mobile Broadband USB Stick. With your USB Stick, you can access a wireless network at high speed.

Logitech Tablet Keyboard for Windows 8, Windows RT and Android 3.0+ Setup Guide Guide d installation

Support Orders and Support Provisions (Banks and Authorized Foreign Banks) Regulations

MANUEL MARKETING ET SURVIE PDF

Comprendre l impact de l utilisation des réseaux sociaux en entreprise SYNTHESE DES RESULTATS : EUROPE ET FRANCE

Cheque Holding Policy Disclosure (Banks) Regulations. Règlement sur la communication de la politique de retenue de chèques (banques) CONSOLIDATION

ANGULAR JS AVEC GDE GOOGLE

Tutoriel compte-rendu Mission 1

First Nations Assessment Inspection Regulations. Règlement sur l inspection aux fins d évaluation foncière des premières nations CONSOLIDATION

3615 SELFIE. HOW-TO / GUIDE D'UTILISATION

Module 7 : Configuration du serveur WEB Apache

Get Instant Access to ebook Cest Maintenant PDF at Our Huge Library CEST MAINTENANT PDF. ==> Download: CEST MAINTENANT PDF

ETABLISSEMENT D ENSEIGNEMENT OU ORGANISME DE FORMATION / UNIVERSITY OR COLLEGE:

TP HTTP. Université Pierre Mendès France U.F.R. Sciences de l Homme et de la Société Master IC²A

Surveillance de Scripts LUA et de réception d EVENT. avec LoriotPro Extended & Broadcast Edition

Acronymes et abréviations. Acronymes / Abbréviations. Signification

TP LINUX : LINUX-SAMBA SERVEUR DE FICHIERS POUR UTILISATEURS WINDOWS

Module Title: French 4

Practice Direction. Class Proceedings

VTP. LAN Switching and Wireless Chapitre 4

Supervision et infrastructure - Accès aux applications JAVA. Document FAQ. Page: 1 / 9 Dernière mise à jour: 15/04/12 16:14

USB 598. Quick Start Guide (Windows) Guide de démarrage rapide (Windows) USB Modem. Modem USB.

LOGICIEL D'ADMINISTRATION POUR E4000 & G4000 MANAGEMENT SOFTWARE FOR E4000 & G4000

Quel temps fait-il chez toi?

Frequently Asked Questions

Institut français des sciences et technologies des transports, de l aménagement

Exercices sur SQL server 2000

APPENDIX 2. Provisions to be included in the contract between the Provider and the. Holder

titre : CENTOS_CUPS_install&config Système : CentOs 5.7 Technologie : Cups Auteur : Charles-Alban BENEZECH

Gestion des références bibliographiques. Comment simplifier la gestion des références bibliographiques?

Exemple PLS avec SAS

COUNCIL OF THE EUROPEAN UNION. Brussels, 18 September 2008 (19.09) (OR. fr) 13156/08 LIMITE PI 53

1 Configuration des Fichiers Hosts, Hostname, Resolv.conf

Telecharger gratuitement convertisseur de fichier word en pdf

COURS 5 Mettre son site en ligne! Exporter son site avec WordPress Duplicator Installer un logiciel FTP Faire le suivi des visites de son site avec

REPARTITION DE CHARGE LINUX

Credit Note and Debit Note Information (GST/ HST) Regulations

DOCUMENTATION - FRANCAIS... 2

Paxton. ins Net2 desktop reader USB

Votre premier projet Android

PRESENT SIMPLE PRESENT PROGRESSIF

Deadline(s): Assignment: in week 8 of block C Exam: in week 7 (oral exam) and in the exam week (written exam) of block D

Transcription:

UTILISER BOOKI 1

2 Published : 2013-02-13 License : None

INTRODUCTION Ce livre explique comment utiliser la plateforme Floss Manuals francophone. La plateforme s'organise en trois grandes sections : Lire : vous y trouverez tous les livres publiés sur la plateforme. Écrire : après inscription (gratuite) vous créez, modifiez et contribuez aux livres de la plateforme. Remixer : créez et exportez votre propre livre à partir des livres présents sur la plateforme. Le site internet présente également d'autres pages : Blog : suivez l'actualité de l'association et de la communauté Floss Manuals francophone. À propos : accédez directement à notre FAQ pour en savoir plus sur l'association, la plateforme, les personnes actives dans le projet. 3

HISTORIQUE 4

INSTALLER 1. L'INSTALLATION 5

1. L'INSTALLATION For most it will not be necessary to have their own Booki software, and every reason not to. Setting up your own Booki and backing up the data on a regular basis is a significant amount of work, and if you're going to share your work with the world there is really no reason not to use the shared Booki as well. If you're not going to share, then having your own Booki makes sense. If you don't have reliable access to the Internet having your own Booki might make sense as well. A school with XO laptops that can connect to each other on a network but not to the Internet might find a local copy of Booki quite valuable. In my own case I set up Booki on a computer at home and another at the office. My day job involves working on an application framework and teaching people how to use it. An application framework is to software what a chassis is to a car, more or less, and just as a factory can build many different cars on the same chassis you can have many applications using the same application framework. T eaching people to use this framework is a challenge, and teaching people who live and work on the other side of the Earth is a greater challenge. We had been using articles on a website, plus a Wiki, to contain the training materials, but after writing two FLOSS Manuals I came to the conclusion that what my company needed was an honest to gosh Book. I installed the software at home because: I wanted the work install to go as quickly and smoothly as possible I want, eventually, to write a book that I will not share with the world. After self-publishing my first FLOSS Manual on Lulu I honestly felt that it would be easier to use Booki to lay out this book (working title: Jim's Oprah Book) than to do the same thing with Open Office or MS Word. If your reasons are like mine, then let's set up our own Booki! GETTING THE SOFTWARE You will need a recent version of Linux to run Booki on. Windows or a Mac will not run Booki. You won't need much of a computer to run it on. T he computer I used at home was a refurbished IBM NetVista which I had bought online for about a hundred dollars. T he computer at work was a discarded desktop model which was even older. I would not recommend trying to install this software on an XO laptop, but any desktop computer made in the last few years should be fine. I used Fedora 13 for these Booki installs, but I don't recommend it. Fedora is used on the XO laptops, and since I write software for that platform I use it on my desktop computers as well. T he downside of Fedora is that, so far, every time I've upgraded to a new version of Fedora I've had to back up all my data and do a complete reinstall. Other than this, the different brands of Linux are more or less the same. If I was going to recommend a Linux for Booki my choices in order would be: 6

Whatever Linux you already have Ubuntu. If you've never used Linux, this is probably the easiest, and I have had good experiences with it. T he rest of these instructions will assume that you have Linux installed and have become comfortable running it. Getting comfortable with Linux is the subject for another book, so if you've never used Linux it would be a good idea to find someone who has to help. Often the install program for Linux will ask if you intend to use it as a web server or if you are doing programming or if you want office software. Answering "Yes" to all three will save some time. T here are actually two parts to Booki, and you'll need both: Booki itself OBJAVI 2, the part that creates PDF's, EPUBs, etc from your Book. installing most software on Linux is no more difficult than checking a check box on anadd/remove Software dialog, but when software is still under development like Booki is you'll need to get the source code and work with that. T he source code for both is kept in a Git repository, so you'll need to have Git installed. Once you do, you can create a "src" directory in your home directory and from in that directory run these commands: git clone git://booki-dev.flossmanuals.net/git/booki.git git clone git://repo.or.cz/objavi2.git T his will create two directories under "src": booki and objavi2, which will contain the source code for these products. Before you can continue, you'll need to check the README.txt file in Booki and the INST ALL file in OBJAVI 2 to find out what other software you'll need to install. For Booki the list is: django apache2 python-simplejson sqlite redis If you're lucky the latest redis will be included as a package in your distribution. Fedora users so far are not so lucky. T hey will need to download the latest source code fromhttp://redis.io/ and compile it using the Makefile in the time honored manner: make sudo make install If you installed it from a package in your distribution you should check the Services to see that it is enabled and running. If you compiled from source you can start it up like this: sudo redis-server & For OBJAVI the list is: 7

lxml pdfedit (4.1+) xvfb fontconfig pdftk psutils poppler-utils or xpdf-utils wkhtmltopdf open office 3 some fonts You can get everything from your distribution's packages except wkhtmltopdf. T hat you'll need to download from http://code.google.com/p/wkhtmltopdf/. You should get a precompiled binary and copy it to the /usr/local/bin directory as user root. When you set up Linux you should get fonts as part of the basic install, but it would be a good idea to install more. In Fedora the Add/Remove Programs dialog has a section forfonts that has over a hundred free fonts that you can install. If you use the Roman alphabet only you can limit yourself to the Latin fonts. 8

DISABLE SELINUX Fedora 12 and later has SELinux. SELinux is to Linux is as Aunt Polly is to Huckleberry Finn. Its job is to keep programs, including the Apache Web Server, from doing things they should not. Even without SELinux Linux is pretty secure. T he web server runs as a user (in Fedora's case the user is named "apache") and it is only allowed to do what that user is allowed to do. On a personal or corporate network this is generally enough. What SELinux does is add an extra layer of protection. Programs are expected to do certain things. If a program tries to do something that SELinux is not expecting, then SELinux stops it. T o get around this you have to tell SELinux to expect this behavior from this specific program. T hen it will be allowed. T his extra layer of protection makes it more difficult for a malicious programmer to break the system. Sooner or later he will have to do something SELinux is not expecting. He will be stopped and his actions will be logged. As commendable as this is, if you have a program that does more than a few unusual things SELinux will be a real challenge. OBJAVI falls into that category. It would be a great deal of work to get SELinux to tolerate all the things that OBJAVI is likely to do, and if you're running it on a private network there wouldn't be much benefit. We disable SELinux byediting a file /etc/selinux/config as user root. T he file should look like this: # This file controls the state of SELinux on the system. # SELINUX= can take one of these three values: # enforcing - SELinux security policy is enforced. # permissive - SELinux prints warnings instead of enforcing. # disabled - No SELinux policy is loaded. SELINUX=disabled # SELINUXTYPE= can take one of these two values: # targeted - Targeted processes are protected, # mls - Multi Level Security protection. SELINUXTYPE=targeted Change the value of SELINUX to disabled, save the file and reboot your computer. CONFIGURE BOOKI AND OBJAVI 2 If you've ever installed anything written in Python on a Linux system you're familiar with the setup.py program, which copies the Python code where it needs to go in the system. Eventually both Booki and OBJAVI will have these, but since they are still being developed they don't have them yet. We will be running the programs out of our home directory for now. T he configuration file for Booki is booki/lib/booki/settings.py. T here is a file namedsettings.py.original which you need to copy to the name settings.py. T here are several places you'll need to modify in this file. First is the doc root: STATIC_DOC_ROOT = '/home/jim/src/booki/site_media' T his points to the site_media directory in the Booki source you got from Git. You'll need to make certain that this directory has a group ownership of apache (or whatever user apache runs as in your distribution) and that the group is allowed to read and create files in this directory. Next you need to set up some URL's: # use this objavi server 9

OBJAVI_URL = "http://127.0.0.1/objavi.cgi" ESPRI_URL = "http://127.0.0.1/espri.cgi" TWIKI_GATEWAY_URL = "http://127.0.0.1/booki-twiki-gateway.cgi" #the name of the booki server (comment out to use os.environ['http_host']) THIS_BOOKI_SERVER = '127.0.0.1:8000' IP Address 127.0.0.1 is of course the localhost IP address. It is likely that you will want to change this to the IP address of your computer so that you can use Booki on the network. You can of course use a DNS name rather than an IP address. Notice that we have Booki running on port 8000. We need to set up virtual hosts for both Booki and OBJAVI. If you can give each one its own IP address or DNS name there is no reason you can't run both on port 80 like a normal web application. If everything has to use the same IP address then you can distinguish your virtual hosts from each other using a port number. Note that OBJAVI has to run on port 80, but Booki can use any port. T here is nothing magic about the number 8000. It just needs to be a port that nothing else is using. In the office I use port 86. Next we have to set up the database entries: DATABASE_ENGINE = 'sqlite3' # DATABASE_NAME = 'booki' # Or path to database file if using sqlite3. DATABASE_NAM E = '/home/jim/booki/booki.db' # Or path to database file if using sqlite3. DATABASE_USER = '' # Not used with sqlite3. DATABASE_PASSWORD = '' # Not used with sqlite3. DATABASE_HOST = 'localhost' # Set to empty string for localhost. Not used with sqlite3. DATABASE_PORT = '' # Set to empty string for default. Not used with sqlite3. Booki can be used with Sqlite3 or Postgres. If you are willing to tinker with the code you could get it to run with just about any database. Sqlite3 is the easiest to set up and is completely adequate for Booki on a small private network. T he only entry you need to touch is DAT ABASE_NAME, which is set to put the database in a directory that can be read and written to by user apache. T here is no need to create the database file. Booki will create it. Now from the command line, as yourself, run this: export PYTHONPATH=$PYTHONPATH:/home/jim/booki/lib where /home/jim is your own home directory. T hen change to the booki/lib/booki directory and run this:./manage.py syncdb T his will create your database tables. Now you can run Booki itself and check it out. First run this as yourself:./manage.py runserver Once this is running you should be able to point your web browser tohttp://127.0.0.1:8000 and see Booki in operation. You should also go tohttp://127.0.0.1:8000/admin and set up an admin user, plus you'll need to add a license like this: 10

You can fool around with Booki some more if you like, but be aware that this is not an adequate way to run Booki. You really need to run it under a virtual host in Apache. manage.py only supports one user at a time, and is only good as a quick sanity check to make sure everything is set up correctly. When you're done looking at Booki you can kill manage.py by pressing Ctrl-C in the terminal where you started it. Next we need to configure OBJAVI. OBJAVI has its own configuration file, objavi2/objavi/config.py. You'll need to change some settings in this file, create some new directories, and make the directories readable and writeable by the apache group. T he first setting to change is this one: WKHTMLTOPDF = '/usr/local/bin/wkhtmltopdf' When you downloaded the binary for wkhtmltopdf it may have had a name like wkhtmltopdf-static or something else. Change the value of WKHT MLT OPDF to whatever name it has in /usr/local/bin. (In my case I had renamed it to wkhtmltopdf, which hurt nothing). T he biggest change is to add an entry to SERVER_DEFAULT S. T he first entry for '127.0.0.1:8000' is my own new entry. Use the actual IP address of your machine if you're going to use it over the network. SERVER_DEFAULTS = { '127.0.0.1:8000 ': { 'css-book': '/static/simmons.css', 'css-web': '/static/en.flossmanuals.net-web.css', 'css-newspaper': '/static/en.flossmanuals.net-newspaper.css', 'css-openoffice': '/static/en.flossmanuals.net-openoffice.css', 'lang': 'en', 'dir': 'LTR', 'toc-encoding': None, 'display': True, 'interface': 'Booki', 'toc_header': 'Table of Contents', }, 'booki.flossmanuals.net': { 'css-book': '/static/en.flossmanuals.net.css', 'css-web': '/static/en.flossmanuals.net-web.css', 'css-newspaper': '/static/en.flossmanuals.net-newspaper.css', 'css-openoffice': '/static/en.flossmanuals.net-openoffice.css', 'lang': 'en', 'dir': 'LTR', 'toc-encoding': None, 'display': False, 'interface': 'Booki', 'toc_header': 'Table of Contents', }, } T he entries that I changed are in bold. I use my own style sheet when creating PDFs for books, and you may wish to do that too. I indicate that I want to display this server in OBJAVI's list of servers and that I don't want to display the other entries. You'll see why in a minute. 11

You need to create some directories under objavi2/htdocs and make certain they can be read and written to by the apache group: books booki-books progress tmp You'll also need to make certain that the static directory already in objavi2/htdocs is writeable by the apache group. Finally, you'll need to set up a log directory under objavi2and make sjure that apache can create files there too. SETTING UP APACHE VIRTUAL HOSTS T he simplest way to get Booki and OBJAVI 2 running under the Apache web server is to set up virtual hosts. What I did was to edit the /etc/httpd/conf/httpd.conf file as the root user using gedit. It is also possible to make configuration files outside of httpd.conf that will be loaded by Apache automatically. I didn't bother to figure out how to do that. T he entries I put at the end of httpd.conf looked like this: Listen 8000 <VirtualHost *:8000> # ServerName sugarlabs.simmons ServerAdmin nicestep@gmail.com DocumentRoot /home/jim/src/booki <Directory /usr/share/pyshared/django/contrib/admin/media/> Order allow,deny Allow from all </Directory> <Location "/"> SetHandler python-program PythonHandler django.core.handlers.modpython SetEnv DJANGO_SETTINGS_MODULE booki.settings PythonDebug On PythonPath "['/home/jim/src/booki/lib'] + sys.path" </Location> <Location "/favicon.ico"> SetHandler None </Location> <Location "/media"> SetHandler None </Location> Alias /favicon.ico /home/jim/src/booki/favicon.ico Alias /media/ /usr/share/pyshared/django/contrib/admin/media/ ErrorLog /var/log/apache2/booki-error.log # Possible values include: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn CustomLog /var/log/apache2/booki-access.log combined ServerSignature On </VirtualHost> <VirtualHost *:80> ServerAdmin nicestep@gmail.com #XXX set server name #ServerName objavi.halo.gen.nz # limit MEM to 800 million bytes RLimitMEM 800000000 #Sometimes it takes a while. Wait. TimeOut 600 DocumentRoot /home/jim/src/objavi2/htdocs <Directory /> 12

Options FollowSymLinks AllowOverride None </Directory> <Directory /home/jim/olpc/objavi2/> Options +All +ExecCGI AllowOverride None Order allow,deny Allow from all AddHandler cgi-script.cgi # Remove output filters in case mod_deflate is being used. RemoveOutputFilter.cgi </Directory> DirectoryIndex index.html objavi.cgi ErrorLog /var/log/apache2/objavi-error.log # Possible values include: debug, info, notice, warn, error, crit, # alert, emerg. LogLevel warn CustomLog /var/log/apache2/objavi-access.log combined #ScriptLog /tmp/objavi-cgi.log </VirtualHost> A Virtual Host is a way of making Apache act like more than one web server. We have one Virtual Host for Booki, and one for OBJAVI 2. When you set up a Virtual Host you need some way for Apache to know which host is needed for a given request. You can do this by giving your server more than one IP address, more than one DNS name, or in my case more than one port. T he Listen directive at the top says that we will be listening at port 8000 in addition to the normal HT T P port 80. When a request comes in on port 8000 it will go to Booki and when it comes in on 80 it will go to OBJAVI 2. Again, OBJAVI 2 must run on port 80. For Booki we're using the mod_python plugin for Apache, so make sure it's installed. 13

USING OBJAVI 2 If you've done everything right you should be able to go to http://127.0.0.1:8000 and see Booki running, and go to http://127.0.0.1 and see OBJAVI 2 running. OBJAVI 2 looks like this: OBJAVI is run from within Book from the Export tab when you're editing a book. If all you want to do is create PDF's and EPUBs you may never need to look at this page. T here is one thing you can do from here that you can't do from Booki's Export tab, and that is to create output as Templated HTML. T o do that you choose T emplated HT ML as thedocument Type. T emplated HT ML is not a kind of e-book, but it is worthy of a brief mention. One of the ways that Booki is different from Wikis like Media Wiki (used for Wikipedia) is that with a normal Wiki anyone can edit any document and the edit is available to the readers of the Wiki instantly. A normal static website makes it easy to control who can update the content, but this control means that updating the content is more work. What Booki introduces is the idea of generating a static website from a Wiki. T he Wiki is used by the book authors but is not seen by the book's audience. When the authors have something ready to publish to the world they use OBJAVI to generate a static website and copy it to the public web server. By default the HT ML looks like the FLOSS Manuals website. Because it is generated using templates, you can easily add your own stylesheets, corporate logos, and the like to make the generated site look the way you want it to. You should definitely think about creating a templated HT ML version of your book if the contents are likely to be updated frequently. T he website version of your book can then act as a supplement to the e- book version. T he stable content will be in the e-book and the latest minor tweaks and corrections will be on the website. 14

LIRE 2. PAGE D'ACCUEIL 15

2. PAGE D'ACCUEIL 16

ECRIRE 3. PRÉSENTATION 4. CRÉER UN NOUVEAU LIVRE 5. CRÉER UN NOUVEAU CHAPITRE DANS UN LIVRE 6. ECRIRE DANS UN CHAPITRE 7. MODIFIER L'APPARENCE DU TEXTE 8. TRADUIRE UN MANUEL 9. AJOUTER DES IMAGES 10. MAINTENIR 11. RELIRE 12. CORRIGER 13. COMMENTER 17

3. PRÉSENTATION La section Ecrire de la plateforme représente la zone d'édition. Après un petit paragraphe présentant succinctement la section, vous trouverez sur la gauche les derniers auteur ayant contribué sur la plateforme. Sur la droite les différentes catégories sont affichés regroupant des livres. Les livres que vous trouverez ici ne sont pas forcément la même version des livres publiés et accessibles de la secion Lire. En effet, avoir deux versions possible d'un même livre, à l'instar du développement de logiciel, permet deux choses : de valider une modification apportée à un livre plutôt que la publier tout de suite, de réaliser la mise à jour d'un livre sans pour autant rendre accessible un livre en cours de modification. A partir de cet endroit, vous pouvez accéder directement aux livres, ou au menu horizontal contenant les liens suivants : Livres : La première ligne montre les 5 livres les plus actifs, la seconde ligne, les 5 derniers livres récemment créés et non cachés, puis enfin la liste classé par ordre alphabétique de tous les livres de la plateforme. 18

En face du nom du livre, trois actions sont possible. Edition vous conduit directement sur l'interface principale de modification du livre, pour en savoir plus reportez-vous à xxx. Information vous renvoie à des données globales sur le livre (état du livre, membre du groupe, version, co-auteurs, date de création et de publication, activité récente, abonnement au flux rss etc.). 19

L'aperçu affiche le livre tel qu'il sera publié sur la plateforme. Actuellement une surimpression rend illisible l'aperçu. Si vous chercher à lire le contenu du livre alors qu'il est actuellement en cours d'édition, utilisez plutôt cette url : http://fr.flossmanuals.net/ecrire/nom-dulivre/. Bien souvent le livre en question appartient au groupe des livres actifs ou des derniers libres, cliquez alors directement sur le nom du livre, cela vous conduira à une vue du livre sans de watermark désagréable. Cependant, cette page contient une fonctionnalité intéressante, celui de récupérer des parties d'un chapitre pour les envoyer à un des co-auteurs inscris sur la plateforme afin de lui demander explicitement sur cette partie, un travail de relecture, de traduction, de modification... 20

Groupes : vous trouverez ici les différentes groupes créés réunissant les livres sur des thèmes. Les livres sont encore trop peu nombreux pour qu'un groupe gère plusieurs livres. mais cela viendra avec le temps? Communauté : cette partie affiche tous les auteurs inscrits sur la plateforme ayant contribué aux livres. Mon profil : affiche les livres que vous avez créés, ainsi que les groupes auxquels vous avez souscrit, et d'autres information facile à comprendre. Mes paramètres : renseignez sur votre adresse e-mail, votre identifiant et votre image de profil. Vous pouvez également entrer quelques lignes sur vous même. Le plus intéressant ici concerne le Filtre de notification (à développer). N'oubiez pas d'enregistrer vos modification en cliquant sur le bouton "Enregistrer le profil de l'utilisateur". Mes livres : Mes groupes, Déconnexion. 21

4. CRÉER UN NOUVEAU LIVRE 22

5. CRÉER UN NOUVEAU CHAPITRE DANS UN LIVRE Pour créer un nouveau chapitre dans un livre, il faut se retrouver sur la page de la table des matières de celui-ci. Au bas de la fenêtre, se présente trois boutons : Nouveau Chapitre, Nouvelle section, Importer chapitre. Cliquez sur Nouveau Chapitre. Une fenêtre s'affiche : Ecrivez dans le champ le nom de votre chapitre et valider en cliquant sur Ajouter le chapitre. PLACER LE CHAPITRE DANS LE FLUX DU SOMMAIRE Par défaut le nouveau chapitre se place au bas de la table des matières. Grâce à votre souris, cliquez long sur le chapitre et glissez le jusqu'à l'emplacement souhaité. Pour savoir comment écrire dans un chapitre, rendez-vous au chapitre en question. 23

6. ECRIRE DANS UN CHAPITRE Vous devez partir de la page de la table des matières pour sélectionner le chapitre à éditer. Une fois que vous avez repéré le chapitre en question Cliquez sur le bouton Modifier. Celui-ci vous conduit directement dans le chapitre où vous pouvez enfin écrire avec l'aide de votre clavier. 24

7. MODIFIER L'APPARENCE DU TEXTE Les icônes présentent au-dessus du titre du chapitre sont là pour faciliter la mise en forme du texte. En tant qu'éditeur FLOSS Manuals Francophone, nous avons déjà écris plusieurs livres et proposons aux co-auteurs de suivre notre mise en page optimisé au fur et à mesure des publications. Les icônes situées en haut ne sont pas véritablement utile, petit à petit nous réduisons leur portée afin de ne pas nuire à la mise en forme générée automatiquement par la plateforme. C'est pourquoi, nous avons créé en janvier 2013 la colonne de droite intégrant des conventions d'écriture établis au fil des mois. Pour appliquer un style, sélectionnez le texte, et avec votre souris, déroulez le menu déroulant Normal ou Classes selon le type de formatage recherché. Le bon formatage est ainsi appliqué directement. METTRE EN FORME Plus précisément, il existe un formatage spécifique de type bloc et un autre de type inline. Le formatage de type bloc formate les paragraphes en quelques sortes (ou les titres). Chaque chapitre doit contenir un grand titre, T itre H1. Le texte courant est stylé automatiquement à Normal. Les sous-titres sont stylé en T itre H2 et ainsi de suite. Nous préférons ne pas aller au-delà de T itre H4. Notes est à utiliser pour insérer des astuces ou des points importants en relation à ce qui a été expliqué dans le paragraphe courant. Il s'écrit de cette façon : Titre de la note (attention, astuces etc) : Texte de la note. Formaté est à utiliser pour insérer des exemples de code dans l'explication. Pour formater simplement des mots dans une phrase, il s'agit de formatage de type inline et concerne les éléments suivants : 25

De la même façon, le formatage s'applique directement et visuellement. 26

8. TRADUIRE UN MANUEL 27

9. AJOUTER DES IMAGES Les images ont leur rôle important à jouer dans l'illustration d'un livre. Il faut se remémorer que les livres de Floss manuals francophone peuvent être destiné à une publication web ou papier, du en pdf en ligne ou imprimé à l'epub. Il est particulièrement difficile qu'une même image puisse correspondre aux bases de qualité recquise pour l'impression, le web ou l'édition électronique, alors faisons juste de notre mieux. Pour l'impression, l'image doit être de 300 dpi minimum. Pour le web pas plus grande que 600 px de large. Pour l'epub de la meilleure qualité possible mais la plus petite possible bref cela semble insoluble. C'est pourquoi les règles communes sont simples : - privilégier les images au format.png. - le nom des images ne doivent pas comporter d'accent, de caractères spéciaux ni d'espace. - version print des images, rajouter -p à la fin de leur nom. - version web des images, rajouter -w à la fin de leur nom. COMMENT FAIRE Cliquer sur l'icône. Cela affiche le dialogue suivant : Cliquer sur l'onglet T éleverser une image. 28

Un champ s'affiche vous invitant à rechercher votre image dans votre disque dur. Lorsque un chemin est renseigné, cliquez sur T éléchargement. Ensuite, retournez à l'onglet Images. Puis sélectionnez l'image en question et enfin cliquez sur Insérer une image. L'image apparaît là où votre curseur est situé dans le chapitre. 29

10. MAINTENIR 30

11. RELIRE 31

12. CORRIGER 32

13. COMMENTER 33

PUBLIER 14. SUR FLOSS MANUALS FRANCOPHONE 34

14. SUR FLOSS MANUALS FRANCOPHONE 35

EXPORTER 15. EN HTML 16. EN PDF 36

15. EN HTML 37

16. EN PDF 38

TÉLÉCHARGER 17. LE PDF PUBLIC DU LIVRE 39

17. LE PDF PUBLIC DU LIVRE Lorsque vous lisez le livre, vous êtes dans la partie Lire du site. À gauche, vous visualisez la table des matières du livre. En haut de celle-ci, vous pouvez télécharger le livre au format epub, pdf, html ou acheter sa version papier ou alors pdf mis en page afin d'optimiser la lecture. Pour accéder à la version pdf du livre généré automatiquement par cette plateforme cliquez sur l'image télécharge sur votre disque dur.. Automatiquement le pdf se Encore une fois, le pdf généré automatiquement ne nous semble pas optimale pour une lecture aisé. C'est pourquoi nous avons utilisé Scribus pour mettre en page les livres papiers et les pdf que nous proposons à la vente. 40

AMÉLIORER 18. SUGGESTIONS 41

18. SUGGESTIONS 42

RENCONTRER DES PROBLÈMES 19. CHAPITRE VIDE 43

19. CHAPITRE VIDE Il arrive parfois de rencontrer des difficultés à écrire ou enregistrer son travail, notamment de rencontrer le chapitre totalement vide, comme l'illustration le montre ci-dessous. Voici une liste des différents problèmes et des solutions qui ont été trouvés. UTILISEZ LE BON NAVIGATEUR Cette plateforme fonctionne avec Firefox et Chromium. Les autres navigateurs peuvent ne pas afficher toutes les fonctionnalités proposées par Booki. DÉSACTIVEZ ADDBLOCK Il existe des extensions pour navigateur fort utile. Malheureusement, certaines extensions rendent impossible l'utilisation de Booki, en rendant la page du chapitre désespéremment vide avec impossibilité d'enregistrer son travail. L'unique solution consiste à désactiver le plug-in en question dans les paramètres de votre navigateurs. Pour Chrome : Il faut cliquer sur l'icône AdBlock situé en haut à droite de la fenêtre. Un menu déroulant s'affiche, choisir alors Désactiver AdBlock pour ce site. Pour Firefox : Cliquez sur le menu déroulant Outils > Modules complémentaires > Extensions > AdBlock > Désactivé. Quitter le chapitre sur lequel vous êtes via le bouton Annuler. Rechargez la page sur laquelle vous êtes et reconnecter vous au chapitre. GRANDE TAILLE DE L'AFFICHAGE 44

D'ÉDITION Il existe un bug qui n'affiche pas toutes les options d'écriture en WYSIWYG. Pour le contourner cliquez Plein écran de votre clavier ou alors sur l'icône si elle est présente puis revenez en mode normal en recliquant sur le même bouton. Vous devriez pouvoir maintenant écrire dans le chapitre directement sans pleine! 45