<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[13516] trunk/readme.html: First pass on readme.html updates.</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/13516">13516</a></dd>
<dt>Author</dt> <dd>nacin</dd>
<dt>Date</dt> <dd>2010-02-28 22:38:56 +0000 (Sun, 28 Feb 2010)</dd>
</dl>
<h3>Log Message</h3>
<pre>First pass on readme.html updates. Include references to the automatic upgrader, the wp-config.php creation script, the new user/pass selection during install. Split system recommendations into requirements and recommendations. Style dt/dl/dd elements. Remove archaic v1.2 to 1.5 theme template reference. Change wording in post via mail and user roles, as neither are new features. Props niallkennedy for minor cleanups in the commit. see <a href="http://trac.wordpress.org/ticket/10835">#10835</a></pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkreadmehtml">trunk/readme.html</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkreadmehtml"></a>
<div class="modfile"><h4>Modified: trunk/readme.html (13515 => 13516)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/readme.html 2010-02-28 21:02:24 UTC (rev 13515)
+++ trunk/readme.html 2010-02-28 22:38:56 UTC (rev 13516)
</span><span class="lines">@@ -2,90 +2,108 @@
</span><span class="cx"> <html xmlns="http://www.w3.org/1999/xhtml">
</span><span class="cx"> <head>
</span><span class="cx"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</span><del>- <title>WordPress &rsaquo; ReadMe</title>
- <link rel="stylesheet" href="wp-admin/css/install.css" type="text/css" />
</del><ins>+ <title>WordPress &#8250; ReadMe</title>
+ <link rel="stylesheet" href="wp-admin/css/install.dev.css" type="text/css" />
</ins><span class="cx"> </head>
</span><span class="cx"> <body>
</span><del>-<h1 id="logo" style="text-align: center">
- <img alt="WordPress" src="wp-admin/images/wordpress-logo.png" />
</del><ins>+<h1 id="logo">
+ <a href="http://wordpress.org/"><img alt="WordPress" src="wp-admin/images/wordpress-logo.png" width="250" height="68" /></a>
</ins><span class="cx"> <br /> Version 3.0
</span><span class="cx"> </h1>
</span><span class="cx"> <p style="text-align: center">Semantic Personal Publishing Platform</p>
</span><span class="cx">
</span><span class="cx"> <h1>First Things First</h1>
</span><span class="cx"> <p>Welcome. WordPress is a very special project to me. Every developer and contributor adds something unique to the mix, and together we create something beautiful that I'm proud to be a part of. Thousands of hours have gone into WordPress, and we're dedicated to making it better every day. Thank you for making it part of your world.</p>
</span><del>-<p style="text-align: right;">&#8212; Matt Mullenweg</p>
</del><ins>+<p style="text-align: right">&#8212; Matt Mullenweg</p>
</ins><span class="cx">
</span><span class="cx"> <h1>Installation: Famous 5-minute install</h1>
</span><span class="cx"> <ol>
</span><del>- <li>Unzip the package in an empty directory.</li>
- <li>Open up <code>wp-config-sample.php</code> with a text editor like WordPad or similar and fill in your database connection details.</li>
- <li>Save the file as <code>wp-config.php</code></li>
- <li>Upload everything.</li>
- <li>Open <span class="file"><a href="wp-admin/install.php">/wp-admin/install.php</a></span> in your browser. This should setup the tables needed for your blog. If there is an error, double check your <span class="file">wp-config.php</span> file, and try again. If it fails again, please go to the <a href="http://wordpress.org/support/">support forums</a> with as much data as you can gather.</li>
- <li><strong>Note the password given to you.</strong></li>
- <li> The install script should then send you to the <a href="wp-login.php">login page</a>. Sign in with the username <code>admin</code> and the password generated during the installation. You can then click on 'Profile' to change the password.</li>
</del><ins>+ <li>Unzip the package in an empty directory and upload everything.</li>
+ <li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser. It will take you through the process to set up a <code>wp-config.php</code> file with your database connection details.
+ <ol>
+ <li>If for some reason this doesn't work, don't worry. It doesn't work on all web hosts. Open up <code>wp-config-sample.php</code> with a text editor like WordPad or similar and fill in your database connection details.</li>
+ <li>Save the file as <code>wp-config.php</code> and upload it.</li>
+ <li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser.</li>
+ </ol>
+ </li>
+ <li>Once the configuration file is set up, the installer will set up the tables needed for your blog. If there is an error, double check your <code>wp-config.php</code> file, and try again. If it fails again, please go to the <a href="http://wordpress.org/support/" title="WordPress support">support forums</a> with as much data as you can gather.</li>
+ <li><strong>If you did not enter a password, note the password given to you.</strong> If you did not provide a username, it will be <code>admin</code>.</li>
+ <li>The installer should then send you to the <a href="wp-login.php">login page</a>. Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on 'Profile' to change the password.</li>
</ins><span class="cx"> </ol>
</span><span class="cx">
</span><span class="cx"> <h1>Upgrading</h1>
</span><del>-<p>Before you upgrade anything, make sure you have backup copies of any files you may have modified such as <code>index.php</code>.</p>
-<h2>Upgrading from any previous WordPress to 3.0:</h2>
</del><ins>+<h2>Using the Automatic Upgrader</h2>
+<p>If you are upgrading from version 2.7 or higher, you can use the automatic upgrader:</p>
</ins><span class="cx"> <ol>
</span><del>- <li>Delete your old WP files, saving ones you've modified.</li>
</del><ins>+ <li>Open the <span class="file"><a href="wp-admin/update-core.php">wp-admin/update-core.php</a></span> in your browser and follow the instructions.</li>
+ <li>You wanted more, perhaps? That's it!</li>
+</ol>
+
+<h2>Upgrading Manually</h2>
+<ol>
+ <li>Before you upgrade anything, make sure you have backup copies of any files you may have modified such as <code>index.php</code>.</li>
+ <li>Delete your old WordPress files, saving ones you've modified.</li>
</ins><span class="cx"> <li>Upload the new files.</li>
</span><span class="cx"> <li>Point your browser to <span class="file"><a href="wp-admin/upgrade.php">/wp-admin/upgrade.php</a>.</span></li>
</span><del>- <li>You wanted more, perhaps? That's it!</li>
</del><span class="cx"> </ol>
</span><del>-<h2>Template Changes</h2>
-<p>If you have customized your templates you will probably have to make some changes to them. If you're converting your 1.2 or earlier templates, <a href="http://codex.wordpress.org/Upgrade_1.2_to_1.5">we've created a special guide for you</a>. </p>
</del><span class="cx">
</span><ins>+<h2>Theme Template Changes</h2>
+<p>If you have customized your theme templates, you may have to make some changes across major versions.</p>
+
</ins><span class="cx"> <h1>Online Resources</h1>
</span><span class="cx"> <p>If you have any questions that aren't addressed in this document, please take advantage of WordPress' numerous online resources:</p>
</span><span class="cx"> <dl>
</span><del>- <dt><a href="http://codex.wordpress.org/">The WordPress Codex </a></dt>
</del><ins>+ <dt><a href="http://codex.wordpress.org/">The WordPress Codex</a></dt>
</ins><span class="cx"> <dd>The Codex is the encyclopedia of all things WordPress. It is the most comprehensive source of information for WordPress available.</dd>
</span><span class="cx"> <dt><a href="http://wordpress.org/development/">The Development Blog</a></dt>
</span><del>- <dd>This is where you'll find the latest updates and news related to WordPress. Bookmark and check often.</dd>
- <dt><a href="http://planet.wordpress.org/">WordPress Planet </a></dt>
</del><ins>+ <dd>This is where you'll find the latest updates and news related to WordPress. Recent WordPress development news appears in your administrative dashboard by default.</dd>
+ <dt><a href="http://planet.wordpress.org/">WordPress Planet</a></dt>
</ins><span class="cx"> <dd>The WordPress Planet is a news aggregator that brings together posts from WordPress blogs around the web.</dd>
</span><span class="cx"> <dt><a href="http://wordpress.org/support/">WordPress Support Forums</a></dt>
</span><span class="cx"> <dd>If you've looked everywhere and still can't find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.</dd>
</span><del>- <dt><a href="http://codex.wordpress.org/IRC">WordPress IRC Channel</a></dt>
- <dd>Finally, there is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="irc://irc.freenode.net/wordpress">irc.freenode.net #wordpress</a>)</dd>
</del><ins>+ <dt><a href="http://codex.wordpress.org/IRC">WordPress <abbr title="Internet Relay Chat">IRC</abbr> Channel</a></dt>
+ <dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="irc://irc.freenode.net/wordpress">irc.freenode.net #wordpress</a>)</dd>
</ins><span class="cx"> </dl>
</span><span class="cx">
</span><del>-<h1>System Recommendations</h1>
</del><ins>+<h1>System Requirements</h1>
</ins><span class="cx"> <ul>
</span><del>- <li>PHP version <strong>4.3</strong> or higher.</li>
- <li>MySQL version <strong>4.1.2</strong> or higher.</li>
- <li>... and a link to <a href="http://wordpress.org/">http://wordpress.org</a> on your site.</li>
</del><ins>+ <li><a href="http://php.net/">PHP</a> version <strong>4.3</strong> or higher.</li>
+ <li><a href="http://www.mysql.com/">MySQL</a> version <strong>4.1.2</strong> or higher.</li>
</ins><span class="cx"> </ul>
</span><del>-<p>WordPress is the official continuation of <a href="http://cafelog.com/">b2/caf&eacute;log</a>, which came from Michel V. The work has been continued by the <a href="http://wordpress.org/about/">WordPress developers</a>. If you would like to support WordPress, please consider <a href="http://wordpress.org/donate/">donating</a>.</p>
</del><span class="cx">
</span><del>-<h1>Upgrading from another system</h1>
-<p>WordPress can <a href="http://codex.wordpress.org/Importing_Content">import from a number of systems</a>. First you need to get WordPress installed and working as described above.</p>
</del><ins>+<h2>System Recommendations</h2>
+<ul>
+ <li>The <a href="http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html">mod_rewrite</a> Apache module.</li>
+ <li>A link to <a href="http://wordpress.org/">http://wordpress.org</a> on your site.</li>
+</ul>
</ins><span class="cx">
</span><del>-<h1>XML-RPC and Atom Interface</h1>
-<p>You can now post to your WordPress blog with tools like <a href="http://windowslivewriter.spaces.live.com/">Windows Live Writer</a>, <a href="http://ecto.kung-foo.tv/">Ecto</a>, <a href="http://bloggar.com/">Bloggar</a>, <a href="http://radio.userland.com">Radio Userland</a> (which means you can use Radio's email-to-blog feature), <a href="http://www.newzcrawler.com/">NewzCrawler</a>, and other tools that support the Blogging APIs! :) You can read more about <a href="http://codex.wordpress.org/XML-RPC_Support">XML-RPC support on the Codex</a>.</p>
</del><ins>+<h1>Migrating from other systems</h1>
+<p>WordPress can <a href="http://codex.wordpress.org/Importing_Content">import from a number of systems</a>. First you need to get WordPress installed and working as described above, before using <a href="wp-admin/import.php" title="Import to WordPress">our import tools</a>.</p>
</ins><span class="cx">
</span><ins>+<h1><abbr title="eXtensible Markup Language">XML</abbr>-<abbr title="Remote Procedure Call">RPC</abbr> and Atom Interface</h1>
+<p>You can post to your WordPress blog with tools like <a href="http://download.live.com/writer">Windows Live Writer</a>, <a href="http://illuminex.com/ecto/">Ecto</a>, <a href="http://bloggar.com/">w.bloggar</a>, <a href="http://radio.userland.com/">Radio Userland</a> (which means you can use Radio's email-to-blog feature), <a href="http://www.newzcrawler.com/">NewzCrawler</a>, and other tools that support the blogging <abbr title="application programming interface">API</abbr>s! :) You can read more about <a href="http://codex.wordpress.org/XML-RPC_Support"><abbr>XML</abbr>-<abbr>RPC</abbr> support on the Codex</a>.</p>
+
</ins><span class="cx"> <h1>Post via Email</h1>
</span><del>-<p>You can post from an email client! To set this up go to your &quot;Writing&quot; options screen and fill in the connection details for your secret POP3 account. Then you need to set up <code>wp-mail.php</code> to execute periodically to check the mailbox for new posts. You can do it with Cron-jobs, or if your host doesn't support it you can look into the various website-monitoring services, and make them check your <code>wp-mail.php</code> URL.</p>
</del><ins>+<p>You can post from an email client! To set this up go to your &quot;Writing&quot; options screen and fill in the connection details for your secret <abbr title="Post Office Protocol version 3">POP3</abbr> account. Then you need to set up <code>wp-mail.php</code> to execute periodically to check the mailbox for new posts. You can do it with <a href="http://en.wikipedia.org/wiki/Cron">cron</a>-jobs, or if your host doesn't support it you can look into the various website-monitoring services, and make them check your <code>wp-mail.php</code> <abbr title="Uniform Resource Locator">URL</abbr>.</p>
</ins><span class="cx"> <p>Posting is easy: Any email sent to the address you specify will be posted, with the subject as the title. It is best to keep the address discrete. The script will <em>delete</em> emails that are successfully posted.</p>
</span><span class="cx">
</span><span class="cx"> <h1>User Roles</h1>
</span><del>-<p>We've eliminated user levels in order to make way for the much more flexible roles system introduced in 2.0. You can <a href="http://codex.wordpress.org/Roles_and_Capabilities">read more about Roles and Capabilities on the Codex</a>.</p>
</del><ins>+<p>We introduced a very flexible roles system in version 2.0, eliminating user levels. You can <a href="http://codex.wordpress.org/Roles_and_Capabilities" title="WordPress roles and capabilities">read more about Roles and Capabilities on the Codex</a>.</p>
</ins><span class="cx">
</span><del>-<h1> Final notes</h1>
</del><ins>+<h1>Final notes</h1>
</ins><span class="cx"> <ul>
</span><del>- <li>If you have any suggestions, ideas, comments, or if you (gasp!) found a bug, join us in the <a href="http://wordpress.org/support/">Support Forums</a>.</li>
- <li>WordPress now has a robust plugin API that makes extending the code easy. If you are a developer interested in utilizing this see the <a href="http://codex.wordpress.org/Plugin_API">plugin documentation in the Codex</a>. In most all cases you shouldn't modify any of the core code.</li>
</del><ins>+ <li>If you have any suggestions, ideas, or comments, or if you (gasp!) found a bug, join us in the <a href="http://wordpress.org/support/">Support Forums</a>.</li>
+ <li>WordPress now has a robust plugin <abbr title="application programming interface">API</abbr> that makes extending the code easy. If you are a developer interested in utilizing this, see the <a href="http://codex.wordpress.org/Plugin_API" title="WordPress plugin API">plugin documentation in the Codex</a>. In most all cases you shouldn't modify any of the core code.</li>
</ins><span class="cx"> </ul>
</span><span class="cx">
</span><span class="cx"> <h1>Share the Love</h1>
</span><span class="cx"> <p>WordPress has no multi-million dollar marketing campaign or celebrity sponsors, but we do have something even better&#8212;you. If you enjoy WordPress please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing the author of a media article that overlooks us.</p>
</span><span class="cx">
</span><ins>+<p>WordPress is the official continuation of <a href="http://cafelog.com/">b2/caf&#233;log</a>, which came from Michel V. The work has been continued by the <a href="http://wordpress.org/about/">WordPress developers</a>. If you would like to support WordPress, please consider <a href="http://wordpress.org/donate/" title="Donate to WordPress">donating</a>.</p>
+
</ins><span class="cx"> <h1>Copyright</h1>
</span><del>-<p>WordPress is released under the <abbr title="GNU Public License">GPL</abbr> (see <a href="license.txt">license.txt</a>).</p>
</del><ins>+<p>WordPress is released under the <abbr title="GNU Public License">GPL</abbr>v2 (see <a href="license.txt">license.txt</a>).</p>
</ins><span class="cx">
</span><ins>+
</ins><span class="cx"> </body>
</span><span class="cx"> </html>
</span></span></pre>
</div>
</div>
</body>
</html>