pitosalas / blogbridge

BlogBridge, the cross platform, open source, blog and rss reader with super powers!

This URL has Read+Write access

blogbridge / devsetupinstructions.html
471d4c10 » Aleksey Gureiev 2009-01-06 Initial 1 <html>
2
3 <head>
4 <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
5 <meta name=Generator content="Microsoft Word 11 (filtered)">
6 <title>Instructions for setting up a BlogBridge</title>
7 <style>
8 <!--
9 /* Font Definitions */
10 @font-face
11 {font-family:Verdana;
12 panose-1:2 11 6 4 3 5 4 4 2 4;}
13 /* Style Definitions */
14 p.MsoNormal, li.MsoNormal, div.MsoNormal
15 {margin:0in;
16 margin-bottom:.0001pt;
17 font-size:10.0pt;
18 font-family:Verdana;}
19 h1
20 {margin-top:12.0pt;
21 margin-right:0in;
22 margin-bottom:3.0pt;
23 margin-left:0in;
24 page-break-after:avoid;
25 font-size:16.0pt;
26 font-family:Arial;}
27 a:link, span.MsoHyperlink
28 {color:blue;
29 text-decoration:underline;}
30 a:visited, span.MsoHyperlinkFollowed
31 {color:purple;
32 text-decoration:underline;}
33 @page Section1
34 {size:8.5in 11.0in;
35 margin:1.0in 1.25in 1.0in 1.25in;}
36 div.Section1
37 {page:Section1;}
38 /* List Definitions */
39 ol
40 {margin-bottom:0in;}
41 ul
42 {margin-bottom:0in;}
43 -->
44 </style>
45
46 </head>
47
48 <body lang=EN-US link=blue vlink=purple>
49
50 <div class=Section1>
51
52 <p class=MsoNormal align=center style='text-align:center'><b>Instructions for
53 setting up a BlogBridge<br>
54 development environment under Windows</b></p>
55
56 <p class=MsoNormal><u>Document History</u></p>
57
58 <p class=MsoNormal>9/13/04�������� Original, David Coletta, <a
59 href="mailto:david@colettas.org" title="mailto:david@colettas.org">david@colettas.org</a></p>
60
61 <p class=MsoNormal>8/5/05��������� Misc updates, Paul Kleppner, <a
62 href="mailto:david@colettas.org" title="mailto:david@colettas.org">pkleppner@gmail.com</a></p>
63
64 <p class=MsoNormal>&nbsp;</p>
65
66 <h1>Download and Install Eclipse</h1>
67
68 <ol start=1 type=1>
69 <li class=MsoNormal>Visit <a href="http://www.eclipse.org/downloads/index.php"
70 title="http://www.eclipse.org/downloads/index.php">http://www.eclipse.org/downloads/index.php</a>
71 and pick one of the download locations to obtain the&nbsp;&nbsp;Eclipse
72 3.1 SDK. </li>
73 <li class=MsoNormal>Unzip the zip file into a directory. </li>
74 <li class=MsoNormal>To launch Eclipse, just run eclipse.exe in the top level
75 directory. </li>
76 </ol>
77
78 <h1>Download and Install Java2 SDK</h1>
79
80 <ol start=1 type=1>
81 <li class=MsoNormal>Visit <a
82 href="http://java.sun.com/j2se/1.4.2/download.html"
83 title="http://java.sun.com/j2se/1.4.2/download.html">http://java.sun.com/j2se/1.4.2/download.html</a>
84 and click on the link to download the J2SE SDK. </li>
85 <li class=MsoNormal>Download and install the J2SE.&nbsp; (Current version as
86 of Sept 2004: 1.4.2_05) </li>
87 </ol>
88
89 <p class=MsoNormal><em><span style='font-size:9.0pt;font-family:Verdana'>Note:
90 it's not clear to me which Java2 SDK version to recommend.&nbsp; It's probably
91 best to avoid the 1.5 version, because we don't want to depend on users having
92 that installed. But it might be better to use an earlier version of 1.4 in
93 order to avoid depending on bug fixes from later 1.4 versions that users may
94 not have installed.&nbsp; </span></em></p>
95
96 <h1>Download and Install the BlogBridge Tree</h1>
97
98 <ol style='margin-top:0in' start=1 type=1>
99 <li class=MsoNormal>In Eclipse, switch to the CVS Repository
100 perspective.&nbsp; (Windows <span style='font-family:Arial'>&#8594;</span>
101 Open Perspective; choose CVS Repository Exploring)</li>
102 <li class=MsoNormal>Right-click in blank CVS Repositories pane, and click New<span
103 style='font-family:Arial'>&#8594;</span>Repository Location</li>
104 <li class=MsoNormal>For configuration, enter:</li>
105 </ol>
106
107 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; <b>hostname</b>: �������� <span
108 style='font-family:"Courier New"'>cvs.sourceforge.net</span></p>
109
110 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; <b>repository</b> <b>path</b>:
111 <span style='font-family:"Courier New"'>/cvsroot/blogbridge</span></p>
112
113 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; <b>user</b>: ���������������� <span
114 style='font-family:"Courier New"'>anonymous</span></p>
115
116 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; <b>password</b>: ��������� &lt;<em><span
117 style='font-family:Verdana'>leave blank</span></em>&gt;</p>
118
119 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; <b>connection</b> <b>type</b>:
120 <span style='font-family:"Courier New"'>pserver</span></p>
121
122 <p class=MsoNormal style='margin-left:.5in'>&nbsp;&nbsp; use default port���������� </p>
123
124 <ol style='margin-top:0in' start=4 type=1>
125 <li class=MsoNormal>Navigate to HEAD/BlogBridge</li>
126 <li class=MsoNormal>Right-click blogbridge and choose &quot;Check Out&quot;</li>
127 </ol>
128
129 <p class=MsoNormal>&nbsp;</p>
130
131 <h1><em><span style='font-family:Arial;font-style:normal'>Configure Eclipse</span></em></h1>
132
133 <ol style='margin-top:0in' start=1 type=1>
134 <li class=MsoNormal>Under Windows<span style='font-family:Arial'>&#8594;</span>Preferences,
135 go to the element &quot;Java/Installed JRE's&quot; and make sure that the
136 1.4.x JRE is checked as default.&nbsp; If not there, add it: click Add,
137 navigate to the JRE directory (e.g. c:\program files\Java\j2re1.xxxx; give
138 JRE a name).</li>
139 </ol>
140
141 <p class=MsoNormal>&nbsp;</p>
142
143 <p class=MsoNormal style='margin-left:.5in'><em><span style='font-size:9.0pt;
144 font-family:Verdana'>Note: I later switched to an SourceForge account for which
145 I was given BlogBridge source read/write privileges. At that time I needed to
146 switch the protocol to to </span></em><strong><span style='font-size:9.0pt;
147 font-family:Verdana'>extssh</span></strong><span style='font-size:9.0pt'>, <em><span
148 style='font-family:Verdana'>and of course change the user name and
149 password.&nbsp; - Paul.</span></em></span></p>
150
151 <p class=MsoNormal>&nbsp;</p>
152
153 <ol style='margin-top:0in' start=2 type=1>
154 <li class=MsoNormal>Install the BlogBridge standard Java format.&nbsp; You'll
155 need &quot;bbstyle.xml&quot;, which is available from Pito. (<em><span
156 style='font-family:Verdana'>Checked into CVS somewhere yet?).&nbsp; </span></em>To
157 install: go to Windows<span style='font-family:Arial'>&#8594;</span>Preferences,
158 select Java/Code Style/Formatter, and import bbstyle.xml.</li>
159 </ol>
160
161 <p class=MsoNormal>&nbsp;</p>
162
163 <h1>Build BlogBridge </h1>
164
165 <p class=MsoNormal>Click Project<span style='font-family:Arial'>&#8594;</span>Clean...
166 to force a build.</p>
167
168 <p class=MsoNormal>&nbsp;</p>
169
170 <p class=MsoNormal><em><span style='font-size:9.0pt;font-family:Verdana'>Note:
171 I've had various problems in getting the initial build going.&nbsp; Another way
172 to run a build is to right-click on build.xml in the top level of the package
173 explorer tree, and choose Run As</span></em><em><span style='font-size:9.0pt;
174 font-family:Arial'>&#8594;</span></em><em><span style='font-size:9.0pt;
175 font-family:Verdana'>Ant Build . You should see �BUILD SUCCESSFUL� in the
176 Console window. -&nbsp; Paul.</span></em></p>
177
178 <h1>Debug BlogBridge</h1>
179
180 <p class=MsoNormal>1. Choose Run<span style='font-family:Arial'>&#8594;</span>Debug...
181 menu </p>
182
183 <p class=MsoNormal>2. In the �Create, manage and run configurations� window:</p>
184
185 <p class=MsoNormal>&nbsp; -&nbsp; click �New�</p>
186
187 <p class=MsoNormal>&nbsp; -&nbsp; set: Name= BlogBridge</p>
188
189 <p class=MsoNormal>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
190 Project=blogbridge</p>
191
192 <p class=MsoNormal>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
193 Main class = com.salas.bb.core.ApplicationLauncher</p>
194
195 <p class=MsoNormal>3. Click Debug button</p>
196
197 <p class=MsoNormal>&nbsp;</p>
198
199 <p class=MsoNormal>You should see the BlogBridge splash screen and first dialog.</p>
200
201 <p class=MsoNormal>&nbsp;</p>
202
203 <p class=MsoNormal>For future debugging, click the F11 key or choose the Debug
204 icon in the Eclipse toolbar.</p>
205
206 <p class=MsoNormal>&nbsp;</p>
207
208 </div>
209
210 </body>
211
212 </html>