|
|
(266 intermediate revisions by 4 users not shown) |
Line 1: |
Line 1: |
− | To Wikify: [http://experiment.dreamwidth.org/9596.html http://experiment.dreamwidth.org/9596.html]
| + | #REDIRECT [[Newbie_Guide:_Getting_Started_on_Windows]] |
− | | + | |
− | = Installing and Settings Things Up =
| + | |
− | | + | |
− | You'll only have to do this once.
| + | |
− | | + | |
− | | + | |
− | == Get a Dreamhack ==
| + | |
− | | + | |
− | What's a Dreamhack? To put it simply, it's a mirror of the Dreamwidth site where you can test your changes.
| + | |
− | | + | |
− | * Apply for a Dreamhack by [http://hack.dreamwidth.net/apply.shtml filling this form].
| + | |
− | | + | |
− | * Get [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY] - choose the 'Windows installer for everything except PuTTYtel' .exe file - and install it.
| + | |
− | | + | |
− | * Run PuTTY. In the configuration window, enter "hack.dreamwidth.net" for the host name. Go to Connection/Data and enter the username/login given to you in the welcome e-mail. It should be something like dh-xxx.
| + | |
− | | + | |
− | : You may also want to change the Window/Appearance, Window/Colours and Window/Selection settings.
| + | |
− | | + | |
− | : Once you're done, go back to Session. Select Default Settings and click on Save.
| + | |
− | | + | |
− | * Click on Open. Click Yes on the pop-up message box.
| + | |
− | | + | |
− | * Enter the password given to you in the welcome e-mail when asked. Note that no characters are displayed and the cursor won't move. It's normal.
| + | |
− | | + | |
− | * Change your password by typing: <source lang="bash">passwd</source>
| + | |
− | | + | |
− | * On your Dreamhack, the default user is called 'system'. You need to set its password so you can access this account. Type: <source lang="bash">$LJHOME/bin/upgrading/make_system.pl</source>
| + | |
− | | + | |
− | * Once you're done type: <source lang="bash">start-apache</source>
| + | |
− | | + | |
− | * You can access your Dreamhack at [http://yourusername.hack.dreamwidth.net/ http://yourusername.hack.dreamwidth.net/] and log in as system. You may want to upgrade your account to a paid one by [http://www.ninetydegrees.hack.dreamwidth.net/admin/capedit going here].
| + | |
− | | + | |
− | | + | |
− | == Install WinSCP ==
| + | |
− | | + | |
− | What for? WinSCP will allow you to see and manage the files of your Dreamhack. You'll use it to edit the theme/layout files.
| + | |
− | | + | |
− | * Install [http://winscp.net/eng/download.php WinSCP]. I chose the Explorer mode because I don't need to access any files on my computer but choose what's best for you.
| + | |
− | | + | |
− | * Use "hack.dreamwidth.net" for the host name. Enter your username and password. Click on Save then on Login.
| + | |
− | | + | |
− | | + | |
− | == Set Up Your Dreamhack ==
| + | |
− | | + | |
− | Again?! Yes, you need to create some files that will make keeping your Dreamhack up-to-date easier.
| + | |
− | | + | |
− | * Follow the steps outlined at [[Dreamhack_getting_started#Back_up_your_configs|Back Up Your Configs]].
| + | |
− | | + | |
− | : N.B. To create files, go to WinSCP, go to the right directory, right-click on New/File and edit.
| + | |
− | | + | |
− | * Also create the <em>dwu</em>, <em>dws</em> and <em>dwdb</em> scripts as explained in [[Dev_Maintenance#Scripting|Scripting]].
| + | |
− | | + | |
− | * In PuTTY, type this then Enter:
| + | |
− | <source lang="bash">cd $LJHOME/cvs/dw-free
| + | |
− | hg qinit -c</source>
| + | |
− | | + | |
− | : This will create a directory where your patches will be put into: <code>~/dw/csv/dw-free/.hg/patches/</code>
| + | |
− | | + | |
− | * Do the same thing with dw-nonfree if you're working with non-free styles:
| + | |
− | | + | |
− | <source lang="bash">cd $LJHOME/cvs/dw-nonfree
| + | |
− | hg qinit -c</source>
| + | |
− | | + | |
− | : The directory will be: <code>~/dw/csv/dw-nonfree/.hg/patches/</code>
| + | |
− | | + | |
− | | + | |
− | == Create a Bugzilla account ==
| + | |
− | | + | |
− | Simply [http://bugs.dwscoalition.org/createaccount.cgi click here].
| + | |
− | | + | |
− | | + | |
− | = How All of This Works =
| + | |
− | | + | |
− | * Your Dreamhack has two parts:
| + | |
− | ** the live part (<code>~/dw/*</code>)
| + | |
− | ** two main repository parts (<code>~/dw/cvs/dw-free/*</code> and <code>~/dw/cvs/dw-nonfree/*</code>).
| + | |
− | | + | |
− | * What you see on [http://yourusername.hack.dreamwidth.net/ http://yourusername.hack.dreamwidth.net/] is the live part.
| + | |
− | | + | |
− | * But you edit files in the repository parts and you create patches in the repository parts.
| + | |
− | | + | |
− | * To make the live part match the repository parts, you use 'synchronize': <source lang="bash">dws</source>
| + | |
− | | + | |
− | * You also use 'update database':<source lang="bash">dwdb</source>
| + | |
− | | + | |
− | * You mustn't forget to regularly update the repository parts by running 'update':<source lang="bash">dwu</source>
| + | |
− | | + | |
− | :Of course, you'll have to run <code>dws</code> and <code>dwdb</code> again after that. You'll do this often. :)
| + | |
− | | + | |
− | * To edit files, you use WinSCP.
| + | |
− | | + | |
− | * To create patches and update code, you use PuTTY.
| + | |
− | | + | |
− | * To find bugs, file bugs, upload patches, you use Bugzilla.
| + | |
− | | + | |
− | | + | |
− | = Before You Fix Anything =
| + | |
− | | + | |
− | | + | |
− | == Find or File a Bug ==
| + | |
− | | + | |
− | * To find: [http://bugs.dwscoalition.org/query.cgi use general search] or [http://bugs.dwscoalition.org/buglist.cgi?bug_status=NEW&keywords=why-styles&keywords_type=allwords&query_format=advanced&order=bug_id%20DESC&query_based_on= stricter search ].
| + | |
− | | + | |
− | * To file: [http://bugs.dwscoalition.org/enter_bug.cgi?alias=&assigned_to=nobody%40dreamwidth.org&blocked=&bug_file_loc=http%3A%2F%2F&bug_severity=enhancement&bug_status=ASSIGNED&comment=&component=Style%20System&contenttypeentry=&contenttypemethod=autodetect&contenttypeselection=text%2Fplain&data=&dependson=&description=&flag_type-1=X&flag_type-10=X&flag_type-11=X&flag_type-2=X&flag_type-3=X&flag_type-5=X&flag_type-7=X&form_name=enter_bug&keywords=&maketemplate=Remember%20values%20as%20bookmarkable%20template&op_sys=All&priority=P5&product=Dreamwidth%20Development&qa_contact=denise%40dreamwidth.org&rep_platform=All&short_desc=&target_milestone=-undecided-&version=unspecified use this template]. Fill and edit the fields as needed and don't forget to change the e-mail address in Assign To.
| + | |
− | | + | |
− | == Create a Patch ==
| + | |
− | | + | |
− | * First make sure nobody's working on the files you want to edit. If there are already patches up for review/commit, you may need to import and apply these patches to your Dreamhack first to avoid conflicts. You can see patches up for commit by [http://bugs.dwscoalition.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=needs-commit&sharer_id=2 clicking here].
| + | |
− | | + | |
− | * Update everything. You need to work with the latest code.
| + | |
− | | + | |
− | * In PuTTY, go to the patch directory by typing this then Enter:
| + | |
− | <source lang="bash">cd $LJHOME
| + | |
− | tocvs</source>
| + | |
− | | + | |
− | : To go to dw-nonfree, type this then Enter:
| + | |
− | <source lang="bash">cd $LJHOME
| + | |
− | tocvs n</source>
| + | |
− | | + | |
− | * Create a new patch by typing this then Enter (change NUMBER and PATCHNAME of course):
| + | |
− | <source lang="bash">hg qnew -g bug#NUMBER_PATCHNAME.diff</source>
| + | |
− | | + | |
− | | + | |
− | [[Category:Styles Development]] | + | |