Skip to content

📗 An open book as a base for teaching and learning about open source product design; a collective understanding of what one should know today to get started and join the movement; a reference students, amateurs and educators can have in their back pocket when they go out to explain what they are passionate about.

Notifications You must be signed in to change notification settings

jbeguna04/open-guide

 
 

Repository files navigation

Diverted Derived Design

These are the source files of a collectively written book today called Diverted Derived Design (formerly Guía abierta a objetos abiertos). This is a project initiated by Libre Objet during Interactivos?'15 at Medialab Prado, Madrid.

We hope that this book can be a base for teaching and learning about open source product design; a collective understanding of what one should know today to get started and join the movement; a reference students, amateurs and educators can have in their back pocket when they go out to explain what they are passionate about.

Early versions of this book were on display in an exhibition called Objetos Comunes until March 31, 2015 at Medialab Prado.

License

Free Art License 1.3

Help Wanted

Any help in proof reading, sharing, commenting, creating issues or sending suggestions is very appreciated. But more specifically, if you'd like to help us in these two fields, please reach to us.

Illustration / Graphic design

Any graphic designer or illustrator willing to give a hand making this book beautiful.

Translations

If you find this book worth reading and sharing, there might be people in your community that could benefit from a native language translation. If you'd like to join a team of translators, please contact us at [email protected]

Looking for more translators in these languages:

  • Euskadi
  • Español (See issue #11)
  • Català
  • Français

Editing tips

We did a lot of tweaking and crude hacks to get Gitbook working a layout that was pleasing us. Especially with images.

So for things to display correctly, images must be on their own line, with a blank line before and after it. Images have also special keywords in their alt description that force one layout or another (see the ones with **Pict** or logo in it).

Build

If you wish to build this book yourself, you will need Npm, Grunt, Gitbook, Calibre and ImageMagick.

Grunt handles the building of the different files.
A special version of Gitbook is used, mainly to better handle fonts in the pdfs.
Calibre is required by Gitbook to make pdfs, epub and mobi.
Imagemagick is used to compress the images for the web version of the book.

All the following instructions are for Linux (Debian family) but could easily be adapted for any system.

Install software

First, you need to have Git, NodeJs and Imagemagick installed.

sudo apt-get install git nodejs npm imagemagick

or

brew install git nodejs npm imagemagick

If you want to make PDF, Ebook and MOBI versions of the book, you will also need Calibre. Please follow the official instructions to install Calibre on your system. This is not necessary if you just wish to see the book in a browser.

Install components

Next, we'll install some Nodejs components to make the book. Create a directory for the project and go into that directory.

mkdir libre-objet
cd libre-objet

Install Gitbook software:

npm install gitbook-cli -g

Copy our modified version of the Gitbook files (we hope to use the official ones in the future, but until some options have been added, you need to use this one):

git clone https://github.com/xuv/gitbook.git

Tell Gitbook software to use our version:

gitbook alias ./gitbook latest

Then finally, download the book source files:

git clone https://github.com/libreobjet/open-guide

We are also sing Grunt to some automatic building. So you'll need that.

sudo npm install -g grunt-cli

And then in the open-guide folder you just cloned do

npm install
gitbook install

It should install all the necessary components to build the book.

Building the book

To view the book in a browser, go into the open-guide folder and launch gitbook.

grunt serve

The book should now be accessible at the address: http://localhost:4000
Press CTRL+c to stop the process.

If you have Calibre installed, you can type this to generate a PDF :

grunt pdf

About

📗 An open book as a base for teaching and learning about open source product design; a collective understanding of what one should know today to get started and join the movement; a reference students, amateurs and educators can have in their back pocket when they go out to explain what they are passionate about.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 82.6%
  • CSS 15.0%
  • HTML 2.1%
  • Shell 0.3%