Thanks to visit codestin.com
Credit goes to github.com

Skip to content

giardiv/dodoc-machinerie

Repository files navigation

DoDoc logo

Presentation

DoDoc is a documentation tool, first designed for use in classrooms with children. It is a platform connected to a physical device that operates a camera and a microphone, and enables one to capture traces from an on-going experience for later reflections, reconstructions and creation of narratives.
DoDoc is made by l'atelier des chercheurs (Sarah Garcin, Pauline Gourlet & Louis Eveillard).
You can find more documentation and contribute to the project here.

DoDoc design principles

DoDoc

Screenshots of the app

DoDoc

DoDoc

DoDoc

DoDoc

Two examples of stations made for the app

DoDoc

DoDoc

App and stations being used with children

DoDoc

DoDoc

DoDoc

The app running on a smartphone

DoDoc

A station made for teaching the principles of stop-motion animation

DoDoc


Install DoDoc

Method 1 - the easy way

Download the app

Download the app from the release page: https://github.com/l-atelier-des-chercheurs/dodoc/releases

Method 2 - the long way (for development and editing the source code)

You need node.js and python 2.7 to install DoDoc with this method. On Windows, you also need to install Microsoft’s Windows Build Tools by following the instructions here.

1. Download this repository

Click on Clone or Download in the top right corner of this page, then Download ZIP. Unpack this folder.

2. Open a terminal window

Open a terminal window to execute commands and install DoDoc.

  • Windows: (XP) use this tutorial to open a terminal on Windows or open Command Prompt in the start menu
  • macOS: go to Applications -> Utilities -> Terminal
  • Linux: use a terminal app such as Terminal or Konsole

In your terminal, navigate to the dodoc-master folder with your terminal using the cd command:

cd path/to/dodoc-master

3. Install dependencies

Install dependencies (may take up to 5 minutes):

npm install

4. Run DoDoc

Start DoDoc folder with the following command:

npm start

Update and manage dododc

Update DoDoc with the latest version

As the /dodoc content folder (medias, texts, etc.) is outside the app, just replace the app or redownload this repository and reinstall dependencies. If you know how to use git (which is not covered in this tutorial) you can also pull changes to your local copy.

Moving the content folder

By default, all contents are stored in the user's "My Documents" folder in a /dodoc folder. You can ask DoDoc to create or use a /dodoc folder anywhere else on your computer by clicking on the link in the footer when using DoDoc directly on a computer (and not from a browser on a tablet connected to DoDoc, for example). Clicking this link will open a pop-up window with instructions.

The path to the /dodoc folder is saved in the app so if you reinstall or update it you will need to set it up again.

Creating publication's templates

You can create you own publication's templates for PDF and website export by following the instructions in the readme.txt file at /dodoc/templates/_exemple. You need at least an icone.svg and a style.css file to make a new template.

Contributing or forking DoDoc

We welcome contributions and inputs. Use the Github issue tracker if you encounter a bug or want to suggest a new feature: https://github.com/l-atelier-des-chercheurs/dodoc/issues

Also, some documentations on DoDoc:

--> 1 hackpad with spec (in french): https://hackpad.com/dodoc-5iYRCxUY8D5

--> 1 blog : http://www.lopendoc.org/dodoc/

Debug and edit DoDoc

If submitting bugs, please enable "debug" mode in the footer and restart the app. Navigate to the place with the bug, close the app and go to the following path to get a log text file:

  • on Linux: ~/.config/dodoc/log.log
  • on OS X: ~/Library/Logs/dodoc/log.log
  • on Windows: %USERPROFILE%/AppData/Roaming/dodoc/log.log

To debug DoDoc when it is installed with method 2, you can enable extra-logging with the following command:

npm run debug

To edit the SCSS (css) files, you’ll need to run gulp:

gulp

About

Outil de documentation basé sur Dodoc

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published