Ronja development

How to develop?

If you would like to contribute with development, please keep on mind these facts:

Ronja is User Controlled Technology and therefore the principal design needs the software tools used to be free, parts to be chosen with respect to availability in small quantities, tools to be chosen that most people have them at home or can cheaply install them.
Are you sure How Ronja works?
Please discuss your plans first on the mailing list with lead developer(s) to make sure your development will be able to be effectively utilized and your effort won't end up in vain.
Schematic and PCB creation guidelines

Editing Ronja Sources

Translating into Czech or German

Let's say you know there is a file e. g. building_aw.php (shows at the end of the URL) and you want to translate it from English to German (Czech). Go to Ronja ViewVC interface. If there is any directory component in the URL of the file, go into that directory in the ViewVC. Fetch the highest numbered revision of the file.

Then just copy it to building_aw_ge.php (building_aw_cz.php) Attention: the text encoding is UTF-8. Set your editor for this encoding! Then edit the texts inside from English to German (Czech). The language switching flags are generated automatically when an existence of file with _ge (_cz) suffix is detected.

What is the "Working Copy"?

There isn't any working copy of Ronja sources, what you are getting are full-blown sources. This is just automatically generated based on the hostname it's running on to prevent accidental visitors from thinking it's the official Ronja homepage.

Directory structure

3d - 3D models in BRL-CAD
audio - audio recording of a Ronja lecture
audiofire - Audiofire instructions
aui_forte - AUI Forte instructions
backup - backup of images.twibright.com image database (doesn't contain images, only identifiers and timestamps)
benchpress - Benchpress instructions
bugfixes - Bugfixes
cabling - Ronja Cabling instructions
cabling2 - Ronja Cabling2 instructions
console - Instructions for all Ronja consoles
data - Numeric data from datasheets (LED angular and spectral characteristics) and public source (solar spectrum, human eye response)
datasheets - datasheets for parts used in Ronja
development - development related pages
drawings - 2D drawings in SVG (Sodipodi) and DXF (Qcad 1.x and Qcad 2.x)
equiv - equivalents which are not specific to a single module
failure - contains a video of Ronja filled with water
faq - FAQ entries, each entry is a separate .php file
grx - logos and graphics for the website
guidelines - guidelines for work on Ronja
heating - Ronja Heating instructions
hertz - Ronja Hertz instructions
holder - Instructions for Ronja 10M Holder
inferno - Ronja Inferno instructions
inferno_power_source - Ronja Inferno Power Source instructions
irrx - Ronja Inferno Receiver instructions
ledholder - Ronja LED holder (a part of Ronja Benchpress)
makefiles - all makefiles are here (except one toplevel)
metropoli - Ronja Metropolis instructions
msmt - results of measurements performed by Twibright Labs
nebulus - Ronja Nebulus instructions
nicolas_desir - drawings contributed by Nicolas Desir
plazmatron - Ronja Plazmatron (a holder)
receiver - Ronja 10M Receiver
releases - related to things prepared for release
rexlator - Ronja Rexlator instructions
schematics - Ronja schematics and PCB's (in gEDA format)
sim - electrical simulations in Gnucap
slides - Lecture slides about Ronja
sponsors - list of donors
starquake - Ronja Starquake instructions
technotes - Technical Notes (how the things work)
testing - Testing procedures
tetrapolis - Ronja Tetrapolis instructions
tetrapolis_power_source - Ronja Tetrapolis Power Source instructions
transmitter - Ronja 10M Metropolis Transmitter instructions
tubular_head_130 - Ronja 130mm Tubular Head instructions
tubular_head_90 - Ronja 90mm Tubular Head instructions
twister - Ronja Twister instructions
twister2 - Ronja Twister2 instructions
urls - contains urls.gz which is a gzipped list of urls used by ronja_download script. This list of urls has to be generated on the server because requires downloading the Ronja website and extracting the urls.
userman - a botched attempt for a TeX printed user manual for a Ronja device
utils - helper software for compilation of Ronja tree and for users
vocabulary - php files for inclusion when mentioning a technical term that should be clickable

Validation

To validate the Ronja homepage, download the CD-ROM copy using ronja_download and then enter the created directory and type

chmod a+x ronja.twibright.com/utils/validate_script
ronja.twibright.com/utils/validate_script

to run the validate_script.

Slides featuring development tools

I had a talk on 23rd June 2005 at [www.lugs.ch LUGS] in Zurich about Ronja. Half of the talk was about software tools used. You can download slides for OpenOffice, PowerPoint or in PDF. Note: the slides are a bit broken due to problems of OpenOffice.