|
|
| (268 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 ==
| + | |
| − | | + | |
| − | * 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]] | + | |
