Working on a Styles Bug
Selecting a Layout for your Journal
- Dev_Getting_Started#Finding_something_to_work_on claim an issue
- get the source code from layer
- copy or set up style as necessary
- make changes; compile; check in various browsers, or whatever...
Working with the Code Locally
This guide is written assuming you have some basic knowledge and familiarity with Linux/UNIX, shells, file systems, etc. To work on styles bugs, you will also need familiarity with CSS and the S2 language. Knowledge of Perl is a bonus but not required (unless you want to work on S2.pm or other modules). If you only have Windows to work on, don't despair! It's possible to work with the repositories through the Windows Explorer, too.
Getting the DW Code
Create a main working directory for the Dreamwidth source. Most of the instructions on the wiki are tailored to the source directory being
~/dw/cvs/dw-free but you can use anything you like. I happen to use
"Clone", i.e. download and create the dw-free repository:
$ hg clone http://hg.dwscoalition.org/dw-free $ hg update -C tip
Repeat for the non-free repository, which also contains some of the layouts:
$ hg clone http://hg.dwscoalition.org/dw-nonfree $ hg update -C tip
To begin working with Mercurial Queues, execute these commands in each of your DW repositories to initialize the queue repository. For example, if your working directory is
$ cd ~/dw/cvs/dw-free $ hg qinit -c
There is more information on working with Mercurial Queues on the Dreamwidth Wiki here.
The S2 layers are located in
Generating and Submitting the Patch
In part 3 of the tutorial, I'll go through the process of claiming and patching a bug step by step.