From c7fa4903d10d12aa6ca7e1af287be2e91b916b41 Mon Sep 17 00:00:00 2001 From: saxmatt Date: Fri, 2 Jan 2004 23:15:27 +0000 Subject: [PATCH] Texty edits. Move template stuff to online. git-svn-id: http://svn.automattic.com/wordpress/trunk@691 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- readme.html | 524 +++------------------------------------------------- 1 file changed, 21 insertions(+), 503 deletions(-) diff --git a/readme.html b/readme.html index e785a57923..4a108eaadd 100644 --- a/readme.html +++ b/readme.html @@ -66,7 +66,7 @@

WordPress
-1.0

+Version 1.0

Weblog / News Publishing Tool

Requirements - Installation - Template(s) - Query String Usage - XML-RPC (Blogging APIs) - Post Via Email - Notes

Requirements:

@@ -76,23 +76,24 @@
  • ... and a link to http://wordpress.org on your site.

    • The link will help promote WordPress and is its only mean of promotion.

    -

    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 wishlist? You can also support the WordPress developers.

    +

    WordPress is the official continuation of b2, which comes from Michel V. The work has been continued by the WordPress developers. If you would like to support WordPress, please consider donating.

    This document is currently beta stage, we'll be updating it extensively as WordPress matures. There is also online documentation under development, as well as a wiki.

    Installation:

    New users: 5-minute install.

    1. Unzip the package in an empty directory.
    2. Upload everything. This release is designed to sit in your root folder; i.e, the folder where your WordPress-powered page will reside.
      3. -
    3. The weblogs.com cache file needs to be writable by the web server. CHMOD 666 the weblogs.com.changes.cache file.
      4. -
    4. Point your browser to wp-admin/install-config.php. This will create a configuration file for your installation. You'll need to know your database name, username, password, and host name.
      5. -
    5. Alternately, you may open wp-config-sample.php in a text editor and insert your database name, username, password, and host name as indicated in the comments. (Comments are lines that start with /* or //.) Save this file as wp-config.php, and upload it.
      6. -
    6. Launch /wpfolder/wp-admin/install.php in your browser. This should setup the MySQL database for your blog. Note the password given to you. If there is an error, double check your wp-config.php file, and try again. If it fails again, please go to the support forums 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).
      7. -
    7. During step 2 of the installation, make sure you enter a fully-qualified domain name for your blog url. For example: http://www.yoursite.com/wordpress . Make sure there is no trailing slash at the end of the url.
      8. -
    8. The install script should then send you to the login page. Sign in with the username "admin" and the password generated during the installation. Then click on the item 'My Profile', and change the password. The login page may also be accessed by going to /wpfolder/wp-login.php. Note: you need javascript enabled to launch the profile popup window.
      9. +
    9. (Optional) If you're going to use it, the weblogs.com cache file needs to be writable by the web server. CHMOD 666 the weblogs.com.changes.cache file.
      10. +
    10. +

      Point your browser to wp-admin/install-config.php. This will create a configuration file for your installation. You'll need to know your database name, username, password, and host name.

      +

      Alternately, you may open wp-config-sample.php in a text editor and insert your database name, username, password, and host name as indicated in the comments. (Comments are lines that start with /* or //.) Save this file as wp-config.php, and upload it.

      +
      11. +
    11. Launch /wp-admin/install.php in your browser. This should setup the MySQL database for your blog. Note the password given to you. If there is an error, double check your wp-config.php file, and try again. If it fails again, please go to the support forums 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).
      12. +
    12. The install script should then send you to the login page. Sign in with the username "admin" and the password generated during the installation. Then click on the item 'My Profile', and change the password. The login page may also be accessed by going to wp-login.php.

    Some notes:

    -

    Upgrading from WordPress v0.7x to v1.0:

    +

    Upgrading from any previous WordPress to v1.0:

    Note on upgrading to v1.0:

    @@ -126,502 +127,20 @@
  • WordPress issues should be discussed in our support forums.
    • -

    Upgrading to WordPress v1.0 from Textpattern, GreyMatter, & Blogger

    +

    Upgrading to WordPress v1.0 from Movable Type, Textpattern, GreyMatter, & Blogger

    -

    Templates:

    +

    Templates:

    +

    For information about WordPress templates, please see our online documentation on them.

    First notes:

    - -

    Notes about parameters:

    -
      -
    1. Some template tags can accept optional parameters between the parentheses ().
      2. -
    2. To add a parameter to a tag, enclose it between quotes and put it between the ().
      - Example: <?php my_tag('my parameter'); ?>
      3. -
    3. You may have to put several parameters, for that you separate them with commas.
      - Example: <?php my_tag("first param", "second param"); ?>
      4. -
    4. 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.
      - Example: <?php my_tag("", "second param"); ?>
      5. -
    5. Some template tags, like the_date(), display something only in certain conditions. They generally accept parameters to display something before and after them only when they display something.
      - Example: <?php the_title("<h1>", "</h1>"); ?> would display <h1>title of the post</h1> only if the post has a title
      6. -
    -

    Template tags:

    - - - - - - -
    -

    Deprecated date/time tags:

    - -
    -
    - -
    -
    - - -
    -
    - -
    - -
    -
  • <?php single_cat_title() ?>
    • -This tag is out of the WordPress loop.
    -It outputs the title of the category when you load the page with ?cat= (see 'Usage' section for explanation). When the weblog page is loaded without ?cat=, this tag doesn't display anything. Generally, you could use it like this:
    -   <title><?php bloginfo('name') ?><?php single_cat_title() ?></title>
    -
    Parameters: - -
    - -
    - -
    - - - -
    -
    -
    - -
    - -
    -
    -