Navigation

← Previous Changeset
Next Changeset →

Changeset 426

Timestamp:

10/07/03 19:05:14 (5 years ago)

Author:

saxmatt

Message:

Fixed HTML, updated to not include some more obvious mistakes.

Files:

trunk/readme.html (modified) (1 diff)

Legend:

: Unmodified
: Added
: Removed
: Modified
: Copied
: Moved

trunk/readme.html

r416	r426
1		<!DOCTYPE ~~HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN~~">
2		<html>
	1	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	2	<html xmlns="http://www.w3.org/1999/xhtml">
3	3	<head>
4		<title>WordPress > ReadMe</title>
5		<meta content="text/html; charset=iso-8859-1"
6		http-equiv="Content-Type">
7		<style>
8		<!--
	4	<title>WordPress—ReadMe</title>
	5	<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
	6	<style type="text/css" media="screen">
	7	<!--
9	8	body {
10	9	font-family: Georgia, "Times New Roman", Times, serif;
11		margin-left: 15%;
12		margin-right: 15%;
	10	margin-left: 25%;
	11	margin-right: 25%;
13	12	}
14		p, li {
15		line-height: 135%;
16		padding-bottom: 2px;
	13
	14	h1 {
	15	color: #006;
	16	font-size: 18px;
	17	font-weight: lighter;
17	18	}
18		h1 {
19		font-size: 18px;
20		font-weight: lighter;
21		color: #006;
22		}
	19
23	20	h2 {
24	21	font-size: 16px;
25	22	}
	23
	24	p, li {
	25	line-height: 140%;
	26	padding-bottom: 2px;
	27	}
	28
	29	ul, ol {
	30	padding: 5px 5px 5px 20px;
	31	}
	32
26	33	.params {
27		border-color: #cccccc;
28		border-width: 1px;
29		border-style: solid;
30		padding: 5px;
	34	border: 1px solid #ccc;
	35	font: 12px arial,helvetica,sans-serif;
31	36	margin: 5px;
32	37	margin-left: 20px;
33	38	margin-right: 80px;
34		font-family: arial,helvetica,sans-serif;
35		font-size:12px;
	39	padding: 5px;
36	40	}
37		ul, ol { margin: 0px; padding: 0px; padding-left: 20px; padding-top: 5px; padding-right: 5px; padding-bottom: 5px; }
38		-->
39		</style>
	41	-->
	42	</style>
40	43	</head>
41		<body style="background-color: rgb(255, 255, 255); color: rgb(0, 0, 0);">
42		<table align="center" cellpadding="0" cellspacing="0" border="0"
43		width="600">
44		<tbody>
45		<tr>
46		<td>
47		<p align="center"><img alt="WordPress"
48		src="http://wordpress.org/images/wordpress.gif"><br>
49		<font face="Georgia, Times New Roman, Times, serif" size="2">0.72</font></p>
50		<p align="center">Weblog / News Publishing Tool</p>
51		<p align="center"><a href="#requirements">Requirements</a> - <a
52		href="#installation">Installation</a> - <a href="#templates">Template(s)</a>
53		- <a href="#usage">Query String Usage</a> - <a href="#xmlrpc">XML-RPC
54		(Blogging APIs)</a> - <a href="#postviaemail">Post Via Email</a> - <a
55		href="#notes">Notes</a></p>
56		<a name="requirements"></a>
57		<h1>Requirements:</h1>
58		<ul>
59		<li><strong>PHP4</strong> (version 4.0.6 or higher)</li>
60		<li><strong>MySQL</strong> (version 3.23.23 or higher)</li>
61		<li>Perl (optional - only for the spellchecker)</li>
62		<li>... and a link to <a target="_blank"
63		href="http://wordpress.org">http://wordpress.org</a> on your site.</li>
64		</ul>
65		<p>The link will help promote <a href="http://wordpress.org">WordPress</a>
66		and is its only mean of promotion. </p>
67		<p>WordPress is built from b2, which comes from Michel V. We
68		wouldn't be here without him, so why don't you grab him something from
69		his <a
70		href="http://www.amazon.com/exec/obidos/registry-address-select-done/1XKLC38KDUPXR/103-8901342-4908609">wishlist</a>?</p>
71		<p>This document is currently beta stage, we'll be updating it
72		extensively as WordPress matures.</p>
73		<h1 id="installation">Installation:</h1>
74		<h2>New users: 5-minute install.</h2>
75		<ol>
76		<li>Unzip the package in an empty directory.</li>
77		<li>Copy wp-config.sample.php to wp-config.php. Open
78		wp-config.php in a text editor and modify the variables as explained in
79		the comments. Comments are lines that start with # or /* or //</li>
80		<li>Upload everything. This release is designed to sit in your
81		root folder, IE the folder where your WordPress-powered page will
82		reside.</li>
83		<li>CHMOD 666 the <code>weblogs.com.changes.cache</code> file.</li>
84		<li> Launch <a href="wp-admin/wp-install.php">wp-install.php</a>
85		in your browser. This should setup the MySQL database for your blog. If
86		there is an error, double check your wp-config.php file, and try again.
87		If it fails again, please go to the <a
88		href="http://wordpress.org/support/">support forums</a> and make a
89		post with all the information about the failure (error messages, etc),
90		and your setup (the PHP and MySQL versions on your server, and the
91		browser you were using). <strong>Note the password given to you.</strong></li>
92		<li> Go to <a href="b2login.php">b2login.php</a> and sign in
93		with the login "admin" and the password given to you by the install
94		script. Then click on the menu 'My Profile', and change the password.
95		Note: you need javascript enabled to launch the profile popup window.</li>
96		</ol>
97		<h2>Some notes:</h2>
98		<ul>
99		<li>Whenever you want to post something, just open a browser
100		and go to b2login.php to log in and post.</li>
101		<li>You can also use a bookmarklet and/or a sidebar (IE5+/NS6+)
102		to post.</li>
103		<li> You can also post through the Blogger API, <a
104		href="#xmlrpc">click here</a> for more info.</li>
105		<li> Your site's blog is on b2.php (simple template) and
106		index.php (CSS template), you can rename this file to index.php or any
107		other name you fancy (provided it bears the php extension or is
108		interpreted as a php file by your server).</li>
109		<li> You can also copy b2.php into a new file and modify that
110		new file, it will work too ;)</li>
111		</ul>
112		<h2>Users upgrading from b2 v0.6.1 to WordPress v0.7:</h2>
113		<ul>
114		<li>All you <em>really</em> have to do is replace all the
115		files with newer versions and run <a href="javascript:window.close()">b2-2-wp.php</a>
116		and you should be ready to go.</li>
117		<li>If you're using an older version of b2, it's probably a
118		good idea to upgrade to at least .6.1 before making the leap to
119		WordPress.</li>
120		<li>The templates are so much better, and there is so much more
121		going on than before it's probably worth it to start from scratch and
122		work back to your design.</li>
123		<li>You <em>must</em> update your <code>wp-config.php</code>.
124		There's all sort of new stuff in there.</li>
125		<li>WordPress issues should be discussed in our <a
126		href="http://wordpress.org/support/">support forums</a>.</li>
127		<li><strong>Back up</strong> your database before you do
128		anything. Yes, you. Right now.</li>
129		</ul>
130		<h1 id="templates">Template(s):</h1>
131		<h2>First notes:</h2>
132		<ul>
133		<li>Enclosed is an example of a template, in the file b2.php.
134		You can rename this file to "index.php"or something else (recent b2
135		versions have a default index.php, which is an elaborate CSS-based
136		template).</li>
137		<li>You can have any number of template files, since all they
138		do is extract the posts from the database.</li>
139		<li>Pseudo-template for the comments is in b2comments.php. You
140		needn't rename this file, but you can edit it.</li>
141		<li>The only thing to remember is that it's not actually a
142		template, but a PHP file that you're manipulating. So when you see
143		"don't delete this line", you know you mustn't, unless you want to have
144		a broken page.</li>
145		<li>Required lines are: the first lines that call
146		blog.header.php, the lines with the "while" statement, and the ones
147		with just "}" (it ends the while loop).</li>
148		<li>Between the "while" line and the "}", is the template for
149		your posts.</li>
150		</ul>
151		<h2>Notes about parameters:</h2>
152		<ol>
153		<li> Some template tags can accept optional parameters between
154		the parenthesis <strong>()</strong>.</li>
155		<li>To add a parameter to a tag, enclose it between quotes and
156		put it between the <strong>()</strong>.<br>
157		Example: <code><?php my_tag("my parameter"); ?></code></li>
158		<li>You may have to put several parameters, for that you
159		separate them with commas.<br>
160		Example: <code><?php my_tag("first param","second param"); ?></code></li>
161		<li>The order of parameters is important. If a function accepts
162		2 parameters and you only want to set the second one, you still have to
163		provide the first one, and so on for any number of parameters.<br>
164		Example: <code><?php my_tag("","second param"); ?></code></li>
165		<li>Some template tags, like the_date(), display something only
166		if in some conditions. They generally accept parameters to display
167		something before and after them only when they display something.<br>
168		Example: <code><?php the_title("<h1>","</h1>"); ?></code>
169		would display <h1>title of the post</h1> only if the post
170		has a title<br>
171		<br>
172		</li>
173		</ol>
174		<h1>Template tags:</h1>
175		<blockquote> <strong><?php the_date() ?></strong> <span
176		style="font-family: 'Courier New',Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
177		the date of the post. example: 03.07.01 (default is dd.mm.yy).<br>
178		the date is displayed only on new days. for example if you got 10 posts
179		on the same day, the date for this day is displayed only once.<br>
180		<div class="params">Parameters:
181		<ul>
182		<li>format string (default: "d.m.y")</li>
183		<li>string to display before the date (default is blank)</li>
184		<li>string to display after the date (default is blank)</li>
185		</ul>
186		</div>
187		<br>
188		<strong><?php the_time() ?></strong><br>
189		the time of the post. example: 18:37:00 (default is hh:mm:ss)<br>
190		<div class="params">Parameters:
191		<ul>
192		<li>format string (default: "H:i:s")</li>
193		</ul>
194		</div>
195		<br>
196		<strong>Note:</strong> you can change the way the date &
197		time are displayed in the Options page.<br>
198		once you understand the format strings for the date & time
199		(explained in the Options page), you can change the display right on
200		the template: for example, <strong>the_date(</strong><em>"d.m.Y"</em><strong>)</strong>
201		to have dates like 25.12.2001, <strong>the_time(</strong><em>"B"</em><strong>)</strong>
202		to have Swatch Internet Time.<br>
203		If you change the display of the date on the template, changing it from
204		the options page won't have any effect.br /> <br>
205		<strong>Note about the_date():</strong> if you want all your
206		posts to bear the date, you'll have to use the_time() instead, with a
207		date format string. for example, to have all your posts show like
208		"25.12.2001 @ 8:04:50 AM" you'll have the_time("d.m.Y @ g:i:s A"). you
209		can also repeat this template tag 2 times with 2 different formats:
210		the_time("d.m.Y") for the date, and then later the_time("g:i:s A") for
211		the time of the day.<br>
212		<br>
213		<strong><?php the_weekday() ?></strong><br>
214		This displays the day of the week when the post was made. It works like
215		the_time(), in that it would appear at every post. Weekdays can be
216		obtained with a custom date format string in the_time() or the_date(),
217		but for non-english weekdays you have to edit day-month-trans.php<br>
218		<strong>Note: this tag is OBSOLETE, the_time() and the_date()
219		now use weekdays/months from day-month-trans.php</strong><br>
220		<br>
221		<strong><?php the_weekday_date() ?></strong> <span
222		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
223		Like the_weekday(), but works like the_date(), in that it would appear
224		only on new days.<br>
225		<strong>Note: this tag is OBSOLETE, the_time() and the_date()
226		now use weekdays/months from day-month-trans.php</strong><br>
227		<div class="params">Parameters:
228		<ul>
229		<li>string to display before the weekday_date (default is
230		blank)</li>
231		<li>string to display after the weekday_date (default is
232		blank)</li>
233		</ul>
234		</div>
235		<br>
236		<br>
237		<strong><?php the_ID() ?><br>
238		</strong>the ID (number) of the post.<br>
239		<br>
240		<strong><?php the_title() ?><br>
241		</strong>The title of the post.<br>
242		<div class="params">Parameters:
243		<ul>
244		<li>string to display before the title (default is blank)</li>
245		<li>string to display after the title (default is blank)</li>
246		</ul>
247		</div>
248		<br>
249		<br>
250		<strong><?php the_content() ?> <span
251		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
252		</strong>The text of the post.<br>
253		<div class="params">Parameters:
254		<ul>
255		<li>text to display for the link to the complete entry
256		(default is <em>'(more...)'</em>)</li>
257		<li>0 or 1, whether you want to show the teaser message or
258		not, when showing the complete text (default is 1)</li>
259		<li>a filename of another template, if you want the 'more'
260		link to link to a different template for the complete text of the
261		extended entry (default is the current template)</li>
262		</ul>
263		</div>
264		<br>
265		For example <em><?php the_content("read more","0","blah.php") ?></em>
266		would display a link to <em>blah.php</em>, with the link text <em>read
267		more</em>, and won't display the teaser message.<br>
268		<br>
269		<span
270		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span>
271		To enter an extended entry, just type <em><!--more--></em> in
272		your entry. The part before that comment is the teaser, the part after
273		it is the extended entry. To force the extended entry not to show the
274		teaser message, type <em><!--noteaser--></em> somewhere in your
275		entry.<br>
276		<br>
277		<span
278		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span>
279		To enter an entry with several pages, just type <em><!--nextpage--></em>
280		in your entry to start a new page.<br>
281		<br>
282		<br>
283		<strong><?php next_post() ?> <span
284		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
285		</strong>Displays a link to the next post(s). (Generally you
286		might want to use that tag only in single-post templates)<br>
287		<div class="params">Parameters:
288		<ul>
289		<li>format string for the link (default is "%", where % is
290		replaced with the title of the next post)</li>
291		<li>text to display to announce the link (default is "next
292		post: ")</li>
293		<li>"yes" or "no": display the title of the post, or no
294		(default is "yes")</li>
295		<li>"yes" or "no": display a link to the next post only if
296		the next post is in the same category (default is "no")</li>
297		<li>number: which next post ? if you make it '2', the 2nd
298		next post is linked instead of the 1st next one (default is "1", which
299		means first next post)</li>
300		</ul>
301		</div>
302		<br>
303		<br>
304		<strong><?php previous_post() ?> <span
305		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
306		</strong>Displays a link to the previous post(s). (Generally
307		you might want to use that tag only in single-post templates)<br>
308		<div class="params">Parameters:
309		<ul>
310		<li>format string for the link (default is "%", where % is
311		replaced with the title of the previous post)</li>
312		<li>text to display to announce the link (default is
313		"previous post: ")</li>
314		<li>"yes" or "no": display the title of the post, or no
315		(default is "yes")</li>
316		<li>"yes" or "no": display a link to the next post only if
317		the previous post is in the same category (default is "no")</li>
318		<li>number: which previous post ? if you make it '2', the 2nd
319		previous post is linked instead of the 1st previous post (default is
320		"1", which means first previous post)</li>
321		</ul>
322		</div>
323		<br>
324		<br>
325		<strong><?php next_posts() ?> <span
326		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
327		</strong>Display the URL portion of a link to the next set of
328		posts. <br>
329		Generally you would use this in a template to navigate to the next
330		"set" of posts when the "Show Options" settings for the site is set to
331		"posts paged". The displayed string can be used to construct a link.
332		When the site options are not set to 'posts paged", the next and
333		previous functions will display nothing.<br>
334		<div class="params">Parameters:
335		<ul>
336		<li>Max page number to use. Default "0"; no limit</li>
337		</ul>
338		</div>
339		<br>
340		<br>
341		<strong><?php next_posts_link() ?> <span
342		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
343		</strong> Displays a full link to the next "set" of posts only
344		if show options set to "posts paged" and only if there is another page
345		or partial page of data.<br>
346		<div class="params">Parameters:
347		<ul>
348		<li>A user supplied string. Default "Next Page >>"</li>
349		</ul>
350		</div>
351		<br>
352		<br>
353		<strong><?php previous_posts() ?> <span
354		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
355		</strong>Displays the URL portion of a link to the previous
356		posts.<br>
357		Generally you would use this in a template to navigate to the previous
358		"set" of posts when the "Show Options" settings for the site is set to
359		"posts paged". The displayed string can then be used to construct a
360		link. When the site options are not set to 'posts paged", the next and
361		previous functions will display nothing.<br>
362		<div class="params">Parameters:
363		<ul>
364		<li>No parameters.</li>
365		</ul>
366		</div>
367		<br>
368		<br>
369		<strong><?php previous_posts_link() ?> <span
370		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
371		</strong> Displays a full link to the previous "set" of posts
372		only if show options set to "posts paged" and if there is a previous
373		set, otherwise nothing is displayed.<br>
374		<div class="params">Parameters:
375		<ul>
376		<li>A user supplied string. Default "<< Previous Page"</li>
377		</ul>
378		</div>
379		<br>
380		<br>
381		<strong><?php posts_nav_link() ?> <span
382		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
383		</strong>The function displays a complete navigation set of
384		links including a user definable "separator" with the ability to supply
385		a the text string to be used for the "previous" and "next" links.<br>
386		The default result will produce the following string:<br>
387		<p align="center"><< Previous Page :: Next Page >></p>
388		<div class="params">Parameters:
389		<ul>
390		<li>A user supplied "separator" string. Default " :: "</li>
391		<li>A user supplied "previous" string. Default "<<
392		Previous Page"</li>
393		<li>A user supplied "next" string. Default "Next Page
394		>>"</li>
395		</ul>
396		</div>
397		<br>
398		<br>
399		<strong><?php link_pages() ?> <span
400		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
401		</strong>Displays links to the pages of the post if it's a
402		multiple pages post.<br>
403		<div class="params">Parameters:
404		<ul>
405		<li>string to display before the tag (default is "<br
406		/>", a newline)</li>
407		<li>string to display after the tag (default is "<br
408		/>", a newline)</li>
409		<li>"next" or "number": display links like "next/previous
410		page" or links to each page with the number of the page "1 2 3 4 etc"
411		(default is "number")</li>
412		<li>string to display the "next page" link (default is "next
413		page")</li>
414		<li>string to display the "previous page" link (default is
415		"previous page")</li>
416		<li>format string for the "number of page" link (default is
417		"%", where % is replaced by the number of the page)</li>
418		<li>file name, in case you want to load the posts with
419		multiple pages in a different template (default is the current template)</li>
420		</ul>
421		</div>
422		<br>
423		<br>
424		<strong><?php the_author() ?></strong><br>
425		The author of the post.<br>
426		Depending on the user's profile settings, it can display whether their
427		nickname, login name, first name, last name, both first& last name,
428		or last & first name. look below for more author-related template
429		tags. <br>
430		<br>
431		<strong><?php the_category() ?><br>
432		</strong>the name of the category the post belongs to. you can
433		as an admin add categories, and rename them if needed. default category
434		is 'General', you can rename it too.<br>
435		<br>
436		<strong><?php the_category_ID() ?><br>
437		</strong>The ID (number) of the category the post belongs to.
438		This is static data thatyou can use, for example to associate a
439		category to an image, or a css style.<br>
440		<br>
441		<strong><?php trackback_rdf() ?> <span
442		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span></strong><br>
443		This will include the RDF data that can be used by some weblog tools to
444		locate your posts' trackback URLs.<br>
445		You should put this tag after the <?php the_content() ?> tag in
446		your template, or just before the end of the loop.<br>
447		<br>
448		<strong><?php get_links_list() ?><br>
449		</strong>This tag is out of the b2 loop.<br>
450		It will output a list of
451		all links defined in the Links Manager, listed by category, with
452		category headings, using the
453		settings in the Links Manager to control the display and sorting of
454		links within the categories, and output it as a nested HTML
455		unordered list. That sounds more complicated that it really is.
456		<div class="params">Parameters:
457		<ul>
458		<li>a string to determine category sort order (e.g. 'name',
459		'updated', 'id')<br>
460		</li>
461		</ul>
462		</div>
463		<br>
464		<strong><?php dropdown_cats() ?><br>
465		</strong>This tag is out of the b2 loop.<br>
466		It will display a list of
467		<option name="<em>x</em>"><em>category-name</em></option>,
468		where <em>x</em> is the number of the category and <em>category-name</em>
469		is the name of it.<br>
470		<div class="params">Parameters:
471		<ul>
472		<li>0 or 1, depending if you want to have an option to
473		display all categories (default is 1)</li>
474		<li>text to display for the option to show all categories
475		(default is "All")</li>
476		</ul>
477		</div>
478		<br>
479		you can use it like this: <br>
480		<br>
481		<code><form action="<?php echo $PHP_SELF ?>"
482		method="get"><br>
483		<?php dropdown_cats() ?><br>
484		<input type="submit" name="submit" value="view" /><br>
485		</form></code> <br>
486		<br>
487		<strong><?php list_cats() ?> <span
488		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
489		</strong>This tag is out of the b2 loop.<br>
490		It will display a list of the
491		categories, with links to them. like in b2archive.php, each category is
492		on a line, the only way you can change this is by editing
493		b2.template.functions.php<br>
494		<div class="params">Parameters:
495		<ul>
496		<li>0 or 1, depending if you want to have an option to
497		display all categories (default is 1)</li>
498		<li>text to display for the option to show all categories
499		(default is 'All')</li>
500		<li>sort by: possible values are 'name' and 'ID' (default is
501		'ID')</li>
502		<li>sorting order: possible values are 'asc' for ascending or
503		'desc' for descending (default is 'asc')</li>
504		<li>filename, in case you want to display the categories'
505		posts in another template (default is current template)</li>
506		</ul>
507		</div>
508		<br>
509		<strong><?php bloginfo() ?></strong> <span
510		style="font-family: 'Courier New',Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
511		This tag is out of the b2 loop.<br>
512		It outputs info about your weblog.<br>
513		<div class="params">Parameters:
514		<ul>
515		<li>string: can be 'name' to display the name of your weblog
516		(you set it in the options page), 'url', 'description', 'admin_email',
517		'rss_url' to display the URL of your b2rss.xml file, 'pingback_url' to
518		display the URL of your xmlrpc.php file<br>
519		(default string is 'name')</li>
520		</ul>
521		</div>
522		<br>
523		<strong><?php single_post_title() ?></strong> <span
524		style="font-family: 'Courier New',Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
525		This tag is out of the b2 loop.<br>
526		It outputs the title of the post when you load the page with ?p= (see
527		'Usage' section for explanation). When the weblog page is loaded
528		without ?p=, this tag doesn't display anything. Generally, you could
529		use it like this:<br>
530		<title><?php bloginfo('name') ?><?php
531		single_post_title() ?></title><br>
532		<div class="params">Parameters:
533		<ul>
534		<li>prefix string that will appear before the post's title
535		(default is ' :: ')</li>
536		</ul>
537		</div>
538		<br>
539		<strong><?php single_cat_title() ?></strong> <span
540		style="font-family: 'Courier New',Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
541		This tag is out of the b2 loop.<br>
542		It outputs the title of the category when you load the page with ?cat=
543		(see 'Usage' section for explanation). When the weblog page is loaded
544		without ?cat=, this tag doesn't display anything. Generally, you could
545		use it like this:<br>
546		<title><?php bloginfo('name') ?><?php
547		single_cat_title() ?></title><br>
548		<div class="params">Parameters:
549		<ul>
550		<li>prefix string that will appear before the category's
551		title (default is ' :: ')</li>
552		</ul>
553		</div>
554		<br>
555		<strong><?php single_month_title() ?></strong> <span
556		style="font-family: 'Courier New',Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
557		This tag is out of the b2 loop.<br>
558		It outputs the name of the month when you load the page with ?m= (see
559		'Usage' section for explanation). When the weblog page is loaded
560		without ?m=, this tag doesn't display anything. Generally, you could
561		use it like this:<br>
562		<title><?php bloginfo('name') ?><?php
563		single_month_title() ?></title><br>
564		<div class="params">Parameters:
565		<ul>
566		<li>prefix string that will appear before the month's name
567		(default is ' :: ')</li>
568		</ul>
569		</div>
570		<br>
571		<strong>Note:</strong> The above three functions can be used
572		together to produce the Title of the page:<br>
573		<title><?php bloginfo('name') ?><?php
574		single_post_title(' :: ') ?><?php single_cat_title(' :: ')
575		?><?php single_month_title(' :: ') ?></title><br>
576		Only one, if any, of these functions will produce output, thus the page
577		Title can be customize to the task being done. <br>
578		<br>
579		<br>
580		<strong>More about the author</strong> of the post ? Here goes:<br>
581		<br>
582		<strong><?php the_author_email() ?> - </strong> the
583		author's email.<br>
584		<strong><?php the_author_url() ?></strong> - the author's
585		url.<br>
586		<strong><?php the_author_email() ?></strong> - the
587		author's number of posts.<br>
588		<strong><?php the_author_icq() ?></strong> - the author's
589		ICQ number.<br>
590		<strong><?php the_author_aim() ?></strong> - the author's
591		AIM handle.<br>
592		<strong><?php the_author_yim() ?></strong> - the author's
593		Yahoo Messenger handle.<br>
594		<strong><?php the_author_msn() ?></strong> - the author's
595		MSN Messenger handle.<br>
596		<strong><?php the_author_posts() ?></strong> - the
597		author's post count.<br>
598		<strong><?php the_author_login() ?></strong> - the
599		author's login name in b2. If you want some static data about the
600		author, this is what you're searching for. You can, for example,
601		associate a picture with an author, like this: <em><img
602		src="pictures/<?php the_author_login() ?>.jpg" border="0"></em><br>
603		<strong><?php the_author_ID() ?></strong> - the author's
604		ID number in b2. This number is automatically set when the user
605		registers: to see the ID of an user, go to the Team page. This is
606		static data too, so you can use it like the_author_login() in
607		associating stuff with authors.<br>
608		<br>
609		<strong><br>
610		Tags for permalinks</strong> are:<br>
611		<br>
612		<strong><?php permalink_anchor() ?> <span
613		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span></strong><br>
614		this will display <a name="..."></a>, replacing "..." with
615		the ID or the title of the post in the database.<br>
616		<br>
617		<div class="params">Parameters:
618		<ul>
619		<li>string for kind of anchor: either 'id' that displays
620		'50', or 'title' that displays 'title_of_post_50' (default is 'id')</li>
621		</ul>
622		</div>
623		<br>
624		<strong><?php permalink_link() ?> <span
625		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
626		</strong>this will display the name of the file followed by #ID
627		to link to the post, in the month archive if archive-mode is "monthly".<br>
628		note: this tag does not display the link, for this you've got to type
629		<a href="<?php permalink_link() ?>">text of the
630		link</a>.<br>
631		<div class="params">Parameters:
632		<ul>
633		<li>file name, in case you want to link the archive to a
634		different template (default is the current template)</li>
635		<li>string for kind of link: either 'id' that appends '#50'
636		to the link, or 'title' that appends '#title_of_post_50' (default is
637		'id')</li>
638		</ul>
639		</div>
640		<br>
641		<br>
642		<strong><?php permalink_single() ?> <span
643		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span><br>
644		</strong>this will display the name of the file followed by #ID
645		to link to the entire post (the linked page will also show the extended
646		text on that post if it is an extended entry, and the comments).<br>
647		note: this tag does not display the link, for this you've got to type
648		<a href="<?php permalink_single() ?>">text of the
649		link</a>.<br>
650		<div class="params">Parameters:
651		<ul>
652		<li>file name, in case you want to use a different template
653		for single posts (default is the current template)</li>
654		</ul>
655		</div>
656		<br>
657		<br>
658		<br>
659		<strong>Tags for comments, trackback, and pingback</strong> are:<br>
660		<br>
661		<strong><?php comments_popup_script() ?> <span
662		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span></strong><br>
663		This will include the javascript that is required to open comments,
664		trackback and pingback in popup windows.<br>
665		You should put this tag before the </head> tag in your template.<br>
666		<div class="params">Parameters:
667		<ul>
668		<li>width (default is 400)</li>
669		<li>height (default is 400)</li>
670		<li>file name, in case you want to use a different template
671		for comments (default is b2commentspopup.php)</li>
672		</ul>
673		</div>
674		<br>
675		<br>
676		<strong><?php comments_popup_link() ?><span
677		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span></strong><br>
678		This will display the link to open comments in a popup window, with the
679		number of comments.<br>
680		To edit the popup window's template, edit the file b2commentspopup.php
681		(it's the default one for comments popup).<br>
682		<br>
683		Note:<br>
684		The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_popup_link()</b>'
685		and '<b>pingback_popup_link()</b>'. They take the same parameters.<br>
686		<br>
687		<div class="params">Parameters:
688		<ul>
689		<li>string for comment-less posts (default is "no comments")</li>
690		<li>string for posts with one comment (default is "1 comment")</li>
691		<li>string for posts with 2 or more comments (default is "%
692		comments")<br>
693		Note here that the sign "%" is then replaced by the number of comments.</li>
694		<li>string for CSS class, so you can have a styled link with
695		class="" (default is empty, no CSS class applied)</li>
696		</ul>
697		</div>
698		<br>
699		<br>
700		<strong><?php comments_link() ?><br>
701		</strong> This is a bit like permalink_link, it will display an
702		URL to the comments page, but again you'll have to create the link tag.<br>
703		<br>
704		Note:<br>
705		The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_link()</b>'
706		and '<b>pingback_link()</b>'. They take the same parameters.<br>
707		<br>
708		<div class="params">Parameters:
709		<ul>
710		<li>file name, in case you want to use a different template
711		for comments (default is the current template)</li>
712		</ul>
713		</div>
714		<br>
715		<br>
716		<strong><?php comments_number() ?></strong> <br>
717		This displays the number of comments that have been posted on this
718		post. Example: "5 comments".<br>
719		<br>
720		Note:<br>
721		The same tags exist for TrackBack and Pingback, respectively named '<b>trackback_number()</b>'
722		and '<b>pingback_number()</b>'. They take the same parameters.<br>
723		<br>
724		<div class="params">Parameters:
725		<ul>
726		<li>string for comment-less posts (default is "no comments")</li>
727		<li>string for posts with one comment (default is "1 comment")</li>
728		<li>string for posts with 2 or more comments (default is "%
729		comments")<br>
730		Note here that the sign "%" is then replaced by the number of comments.</li>
731		</ul>
732		</div>
733		<br>
734		Example: <em><?php comments_number("no comment","1 comment","%
735		comments") ?></em><br>
736		<br>
737		This tag differs from v0.5's tag because in v0.5 and prior, it would
738		only display a number, not a text with it, so you could have terrible
739		things like "1 comments" (doh !)<br>
740		<br>
741		<strong>Necessary: <?php include("b2comments.php") ?></strong><br>
742		you'll put this line where you want the comments to be placed on your
743		page.<br>
744		typically, under the post itself. don't worry, the comments only appear
745		if the page is called in the comments mode. (like this: url?c=1)<br>
746		<br>
747		<strong>Necessary: <?php include("b2trackback.php") ?></strong><br>
748		you'll put this line where you want the TrackBacks to be placed on your
749		page.<br>
750		typically, under the post itself. don't worry, the TrackBacks only
751		appear if the page is called in the TrackBacks mode. (like this:
752		url?tb=1)<br>
753		<br>
754		<strong>Necessary: <?php include("b2pingbacks.php") ?></strong><br>
755		you'll put this line where you want the Pingbacks to be placed on your
756		page.<br>
757		typically, under the post itself. don't worry, the Pingbacks only
758		appear if the page is called in the Pingbacks mode. (like this:
759		url?pb=1)<br>
760		<br>
761		<br>
762		<strong>Tags that go in b2comments.php, b2trackback.php,
763		b2pingbacks.php:</strong> (these are easy too)<br>
764		<br>
765		<strong><?php comment_author() ?></strong><br>
766		<strong><?php comment_author_email() ?> </strong> -
767		displays the e-mail address, but not the link<br>
768		<strong><?php comment_author_url() ?> </strong>-
769		displays the url, but not the link<br>
770		<br>
771		<strong><?php comment_author_email_link() ?> </strong> <span
772		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span>-
773		displays a link to the comment's author's e-mail<br>
774		<strong><?php comment_author_url_link() ?> </strong> <span
775		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span>-
776		displays a link to the comment's author's website<br>
777		<div class="params">Parameters for <strong>comment_author_email_link()</strong>
778		and <strong>comment_author_url_link()</strong>:
779		<ul>
780		<li>string for the link (default: "email"/"url" depending on
781		the tag)</li>
782		<li>string to display before the link (default is " - ")</li>
783		<li>string to display after the link (default is blank)</li>
784		</ul>
785		</div>
786		<br>
787		<strong><?php comment_author_IP() ?></strong> - displays
788		the IP of the comment's author<br>
789		<strong><?php comment_text() ?><br>
790		<?php comment_date() ?> </strong>- unlike the_date(), this tag
791		appears on every comment<strong><br>
792		<?php comment_time() ?></strong><br>
793		<div class="params">Parameters for <strong>comment_date()</strong>
794		and <strong>comment_time()</strong>:
795		<ul>
796		<li>format string (default is "d.m.y"/"H:i:s" depending on
797		the tag)</li>
798		</ul>
799		</div>
800		<br>
801		<strong><?php trackback_url() ?> <span
802		style="font-family: Courier New,Courrier,mono; color: rgb(255, 153, 0); font-weight: bold;">*</span></strong><br>
803		This tag is out of the b2 TrackBacks loop.<br>
804		It will output the URL to TrackBack the post, that other people can
805		copy and use in b2's posting interface to trackback this post.<br>
806		<div class="params">Parameters:
807		<ul>
808		<li>no parameter</li>
809		</ul>
810		</div>
811		<br>
812		<br>
813		In b2comments.php b2trackback.php and b2pingbacks.php, like in the main
814		template file, please keep the first PHP lines, the "while" lines, and
815		the "}" lines.<br>
816		You can modify the form, but do not remove "<?php echo ... ?>"
817		and all the name="..." attributes.<br>
818		<br>
819		<br>
820		To <strong>include your archives:</strong><br>
821		<br>
822		<strong><?php include("b2archives.php") ?></strong><br>
823		this will include the links to your archives, one link per line.<br>
824		if your archive mode is "monthly", it will display the names of the
825		months and the years, like "july 2001".<br>
826		if your archive mode is "post by post", it will display the titles of
827		your posts, one title per line. if a post is untitled it will display
828		the ID (number) of this post.<br>
829		<br>
830		<br>
831		To <strong>include the calendar:</strong><br>
832		<br>
833		<strong><?php include("b2calendar.php") ?></strong><br>
834		this will include a table with the current month's calendar, each day
835		when you posted shows a link to this day's posts. You can customise
836		this table with CSS classes:
837		<div class="params"> <strong>.b2calendarmonth {}</strong><br>
838		<i>the style that is used to display the month and year</i><br>
839		<strong>.b2calendartable {}</strong><br>
840		<i>the style of the <table> tag (border etc...)</i><br>
841		<strong>.b2calendarrow {}</strong><br>
842		<i>the style of the <tr> tag</i><br>
843		<strong>.b2calendarheadercell {}</strong><br>
844		<i>the style of the <td> tag that shows the
845		weekdays on the top of the table</i><br>
846		<strong>.b2calendarcell {}</strong><br>
847		<i>the style of the <td> tags that show the days</i><br>
848		<strong>.b2calendaremptycell {}</strong><br>
849		<i>the style of the <td> tags that are empty</i><br>
850		<strong>.b2calendarlinkpost {}</strong><br>
851		<i>the style of the link to the post</i><br>
852		<strong>.b2calendartoday {}</strong><br>
	44	<body>
	45	<p style="text-align: center"><img alt="WordPress" src="http://wordpress.org/images/wordpress.gif" /> <br />
	46	0.72</p>
	47	<p style="text-align: center">Weblog / News Publishing Tool</p>
	48	<p style="text-align: center"><a href="#requirements">Requirements</a> - <a href="#installation">Installation</a> - <a href="#templates">Template(s)</a> - <a href="#usage">Query String Usage</a> - <a href="#xmlrpc">XML-RPC (Blogging APIs)</a> - <a href="#postviaemail">Post Via Email</a> - <a href="#notes">Notes</a></p>
	49	<h1 id="requirements">Requirements:</h1>
	50	<ul>
	51	<li><strong>PHP4</strong> (version 4.0.6 or higher)</li>
	52	<li><strong>MySQL</strong> (version 3.23.23 or higher)</li>
	53	<li>... and a link to <a href="http://wordpress.org">http://wordpress.org</a> on your site.</li>
	54	</ul>
	55	<p>The link will help promote <a href="http://wordpress.org">WordPress</a> and is its only mean of promotion. </p>
	56	<p>WordPress is built from b2, which comes from Michel V. We wouldn't be here without him, so why don't you grab him something from his <a href="http://www.amazon.com/exec/obidos/registry-address-select-done/1XKLC38KDUPXR/103-8901342-4908609">wishlist</a>? You can also support the <a href="http://wordpress.org/about/">WordPress developers</a>. </p>
	57	<p>This document is currently <em>beta</em> stage, we'll be updating it extensively as WordPress matures. There is also <a href="http://wordpress.org/docs/">online documentation</a> under development. </p>
	58	<h1 id="installation">Installation:</h1>
	59	<h2>New users: 5-minute install.</h2>
	60	<ol>
	61	<li>Unzip the package in an empty directory.</li>
	62	<li>Copy wp-config.sample.php to wp-config.php. Open wp-config.php in a text editor and modify the variables as explained in the comments. Comments are lines that start with <code>/*</code> or <code>//</code></li>
	63	<li>Upload everything. This release is designed to sit in your root folder, IE the folder where your WordPress-powered page will reside.</li>
	64	<li>The weblogs.com cache file needs to be writable by the web server. <a href="http://www.evolt.org/article/A_quick_and_dirty_chmod_Tutorial/18/541/">CHMOD 666</a> the <code>weblogs.com.changes.cache</code> file. </li>
	65	<li> Launch <a href="wp-admin/wp-install.php">wp-install.php</a> in your browser. This should setup the MySQL database for your blog. If there is an error, double check your wp-config.php file, and try again. If it fails again, please go to the <a href="http://wordpress.org/support/">support forums</a> and make a post with all the information about the failure (error messages, etc), and your setup (the PHP and MySQL versions on your server, and the browser you were using). <strong>Note the password given to you.</strong></li>
	66	<li> Go to <a href="b2login.php">b2login.php</a> and sign in with the login "admin" and the password given to you by the install script. Then click on the menu 'My Profile', and change the password. Note: you need javascript enabled to launch the profile popup window.</li>
	67	</ol>
	68	<h2>Some notes:</h2>
	69	<ul>
	70	<li>Whenever you want to post something, just open a browser and go to b2login.php to log in and post.</li>
	71	<li>You can also use a bookmarklet and/or a sidebar (IE5+/NS6+) to post.</li>
	72	<li> You can also post through the Blogger API, <a href="#xmlrpc">click here</a> for more info.</li>
	73	<li> Your site's blog is on b2.php (simple template) and index.php (CSS template), you can rename this file to index.php or any other name you fancy (provided it bears the php extension or is interpreted as a php file by your server).</li>
	74	<li> You can also copy b2.php into a new file and modify that new file, it will work too ;)</li>
	75	</ul>
	76	<h2>Upgrading from b2 v0.6.1 to WordPress v0.7:</h2>
	77	<ul>
	78	<li>All you <em>really</em> have to do is replace all the files with newer versions and run <a href="javascript:window.close()">b2-2-wp.php</a> and you should be ready to go.</li>
	79	<li>If you're using an older version of b2, it's probably a good idea to upgrade to at least .6.1 before making the leap to WordPress.</li>
	80	<li>The templates are better and structured slightly differently, so it might be worth it to start from scratch and work back to your design.</li>
	81	<li>You <em>must</em> update <code>wp-config.php</code>.</li>
	82	<li>WordPress issues should be discussed in our <a href="http://wordpress.org/support/">support forums</a>.</li>
	83	<li><strong>Back up</strong> your database before you do anything. Yes, you. Right now.</li>
	84	</ul>
	85	<h1 id="templates">Templates:</h1>
	86	<h2>First notes:</h2>
	87	<ul>
	88	<li>Enclosed is an example of a template, in the file b2.php. You can rename this file to "index.php"or something else (recent b2 versions have a default index.php, which is an elaborate CSS-based template).</li>
	89	<li>You can have any number of template files, since all they do is extract the posts from the database.</li>
	90	<li>Pseudo-template for the comments is in b2comments.php. You needn't rename this file, but you can edit it.</li>
	91	<li>The only thing to remember is that it's not actually a template, but a PHP file that you're manipulating. So when you see "don't delete this line", you know you mustn't, unless you want to have a broken page.</li>
	92	<li>Required lines are: the first lines that call blog.header.php, the lines with the "while" statement, and the ones with just "}" (it ends the while loop).</li>
	93	<li>Between the "while" line and the "}", is the template for your posts.</li>
	94	</ul>
	95	<h2>Notes about parameters:</h2>
	96	<ol>
	97	<li> Some template tags can accept optional parameters between the parentheses <strong>()</strong>.</li>
	98	<li>To add a parameter to a tag, enclose it between quotes and put it between the <strong>()</strong>.<br />
	99	Example: <code><?php my_tag('my parameter'); ?></code></li>
	100	<li>You may have to put several parameters, for that you separate them with commas.<br />
	101	Example: <code><?php my_tag("first param", "second param"); ?></code></li>
	102	<li>The order of parameters is important. If a function accepts 2 parameters and you only want to set the second one, you still have to provide the first one, and so on for any number of parameters.<br />
	103	Example: <code><?php my_tag("", "second param"); ?></code></li>
	104	<li>Some template tags, like the_date(), display something only if in some conditions. They generally accept parameters to display something before and after them only when they display something.<br />
	105	Example: <code><?php the_title("<h1>", "</h1>"); ?></code> would display <h1>title of the post</h1> only if the post has a title </li>
	106	</ol>
	107	<h1>Template tags:</h1>
	108	<strong><?php the_date() ?></strong> <br />
	109	the date of the post. example: 03.07.01 (default is dd.mm.yy).<br />
	110	the date is displayed only on new days. for example if you got 10 posts on the same day, the date for this day is displayed only once.<br />
	111	<div class="params">Parameters:
	112	<ul>
	113	<li>format string (default: "d.m.y")</li>
	114	<li>string to display before the date (default is blank)</li>
	115	<li>string to display after the date (default is blank)</li>
	116	</ul>
	117	</div>
	118	<br />
	119	<strong><?php the_time() ?></strong><br />
	120	the time of the post. example: 18:37:00 (default is hh:mm:ss)<br />
	121	<div class="params">Parameters:
	122	<ul>
	123	<li>format string (default: "H:i:s")</li>
	124	</ul>
	125	</div>
	126	<br />