textpattern中文站

txp安装指导

安装其实很简单，和其他的blog和cms程序差不多的，下载、上传、搞定数据库、运行安装向导、按部就班就可以完成安装了。我就不一字字翻译了，大概说说安装的关键。

Overview —概述

This article is intended to help users with the installation process if the rather brief instructions on the Textpattern download page don’t work out for you. We know, sometimes it takes a bit more elaboration.

这篇文章是帮助txp的用户安装textpattern，在官方的下载页面也有相应的安装手册可以看。

Acquisition, Unpacking, and Getting Familiar-获得程序、解压并熟悉目录结构

Acquisition and Unpacking -下载解压

Download the latest release package from the Textpattern download page. Select either .gzip or .zip as you prefer.
Create a logically named folder (e.g., txp-unzipped) on your local drive, and unzip (unpack) the Textpattern package into the folder you create. You can now get familiar with the Textpattern folder/file structure before running through the setup processs.

官方提供的最新正式版程序下载，有.gzip和.zip的格式，选择你喜欢的格式下载，windows用户一般下载.zip格式的就行了。

Getting Familiar with the Folders and Files -熟悉目录结构

All folders and files in the unzipped package are organized under a directory named after the current release. You will install the files and folders contained within this directory; do not install the container directory itself!

Textpattern is designed to work exactly as the folders and files are organized in the unzipped package, it is critical that you do not move, nor rename, any of the folders or files; doing so will cause Textpattern to not function.

There are three folders and three files in the current release (Figure 1).

Figure 1: Contents of the unzipped Textpattern package.

上面的图片就是目录文件，有三个文件夹和三个文件。

• Folders -文件夹

textpattern — is where the guts of Textpattern are stored. All the core scripting and functionality is kept in this folder. Again, do not move nor rename anything!
images — is empty by default, but will be utilized later in the course of building your site, particularly if/when you use the upload features in the Images Subtab of the Site Administration.
files — is empty by default, but will be utilized later in the course of building your site, particularly if/when you use the upload features in the Files Subtab.

最主要的文件夹就是textpattern了，code基本都在这个目录里面，而且安装之后管理登录也是这个目录。images和files默认是空的，这个是你以后使用的时候上传文件放的地方。

• Files -文件

index.php — is effectively the stage of your site where all visitors will alight and where everything takes place dynamically.
.htaccess — is important for many reasons that are out of scope here, but not the least of which is handling URL formatting.
README — provides brief instruction on installing and upgrading.
You will need to consider where on your server the Textpattern files will be installed. This is discussed in the next section, Where to Install on Your Server?.
index.php显然就是首页了咯，.htaccess是配置文件，可以在这里优化你的url之类的，readme是说明。

Where to Install on your Server?

For most people, Textpattern will be used to manage the entire website, whether it’s a blog, business site, or photo gallery, etc. In this case Textpattern will be installed in the root level of your website; e.g., www.yoursite.com. (In case you’re new to owning a Web site, this means in the public_html directory with most Web hosts.)

Others may wish to use Textpattern to manage a sub-section of an existing website, adding a blog, perhaps. In this case Textpattern would be installed to a subdirectory of that domain (e.g., www.yoursite.com/myblog).

Once you’ve decided on the location for your Textpattern install you’ll need to load the files up to your server. This is discussed in the next section, Add Files to your Server.
根据需要选择你要安装的目录，把文件上传到你要安装的服务器目录。

Add Files to your Server

To get files to your server, you will need to use some form of File Transfer Protocol (FTP), so be sure to have one ready before proceeding. (Note: If you are hosted by TextDrive, then you have to use a Secure File Transfer Protocol (SFTP) client. Again, see File Transfer Protocol for details.)

Now you should have an FTP client picked-out, installed, and linked properly with your Web host’s servers. Proceed as follows:

Using your FTP or SFTP client, make a connection to your Web server, and navigate to the directory where you intend to install Textpattern. Then make a second FTP/SFTP connection to your local drive and navigate to the unzipped Textpattern package.
Select all the files and folders within the install package, as per Figure 1, above. Upload these to your server.
With your Textpattern files on your server, you are ready for Textpattern Setup and Configuration.

上传文件到你的服务器，使用ftp或者sftp工具上传，避免不必要的麻烦。

Setup and Configuration

Step 1) Database Setup Screen

Open a Web browser and open the /textpattern/ directory (e.g., www.yoursite.com/textpattern/).
Your browser should now be showing the the first screen of the installation setup (Figure 2), where you will add information about your MySQL database, and verify the site paths that it indicates; if not, double check the path you used to locate the /textpattern/setup/index.php file.
在浏览器中输入你的安装目录，比如你把文件放在www.yourdomain.com/目录下，那么你就输入www.yourdomain.com/textpattern/，你就会看到下面的画面。

Fig 2: Screenshot of Setup information you need to add.

MySQL Database:

进入上面的画面之后，按照你在服务器上建立好的数据库，填写数据库的详细情况，注意Table prefix是为了你在同一个数据库里面建立多个网站准备的，也就是在数据表中加一个txp_这种，安装过dz和pw论坛吗？是一样的意思。
Before you can fill in the MySQL information, you will need to have established a few things on your host server. First, you will need to have given your database a name if it doesn’t already have one. Next, you’ll need to create a database login ID and password, and you’ll need to have set the database login account with “write” privileges. Note also that when you fill in the Textpattern setup screen, you’ll likely need to use your Web host user account ID as a prefix for the fields MySQL login and MySQL database. Here is a guide for how it should look:

MySQL login: yourhostID_databaseUserID
MySQL password: databasePassword
MySQL server: localhost (If “localhost” does not work, check with your host provider about what to use.)
MySQL database: yourhostID_datbaseName
Table prefix: prefix_ (e.g., txp_, txp2_, cats_, whatever_)

The Textpattern setup screen will indicate that you don’t need to provide a table prefix if this will be your only intallation of Textpattern. It is advised that you create a prefix anyway. You might not need a second installation of Textpattern right now, but you might want to have one at a later point in time, and providing a prefix for this installation enables you to do that later. NB: make sure you use valid characters for MySQL for the prefix, only _ underscore $ dollar letters and numbers are allowed.
做好这些之后，就可以按部就班的一步一步next来安装了。
h4. Site Paths:-网站路径

The site paths should already be filled in on your setup screen. You only need to verify that they are correct; but don’t think too much about this, because if you added your Textpattern files as described previously, then these paths will be correct and you don’t have to do anything.

Step 2) Config File Setup Screen

The next stage of installation is to add your database and login details to the textpattern/config.php file as shown in Figure 3 below. Textpattern makes this easy by taking the information you added in step 1 above, generates a snippet of code, and asks you to copy/paste the snippet into the textpattern/config.php file, replacing the contents of the file.

Copy the code that Textpattern generated as indicated on the screen.
Using your FTP client, navigate to textpattern/config-dist.php in the unzipped files on your local drive and remove -dist from the file name (so it reads config.php). Open the file, paste the snippet of code into the file (replacing contents), save the file, and drag the file into the textpattern directory on your server. (If you want, you can delete the extra config-dist.php file from your server, or move it to the unpacked folder on your local drive.)
Go back to your browser window with the config setup screen, and click the “I did it” button for the config setup.

Fig 3: Screenshot of MySQl database details and site paths.

Step 3) Creating Login Account and Tables Generation Screen

At this point, Textpattern is ready for you to add your account login information, as indicated in Figure 4 below, and will then create the necessary tables in the MySQL database.

Create a new user ID and password to administer your Textpattern site. (Note this is not the same ID and password used for your database, as discussed in step 1.)
Click the “Next” button.
Figure 4: Screenshot of account details and tables generation screen.

Step 4) Confirmation and Security Screen

If all has gone well then you should see the screen as shown in Figure 5. Now Textpattern has you delete the setup directory for security reasons. Do it.

Use your FTP client, go to the /textpattern/setup directory and delete it from your server.
Come back to the browser and click the “main interface” link at the top of the screen.
This will take you to the administration login screen for your new Textpattern site.

Figure 5: Screenshot of setup confirmation and setup directory deletion screen. 以上是确认你的安装信息，一般都没问题，直接下一步。

Step 5) First Login Screen-首次登录

You should now have reached the administration login screen for your Textpattern installation. You should immediately make a bookmark for it in your browser for easy reference later.

To login to your admin interface, use the login information you created in step 3 above. If you want to avoid logging in each time you go to your admin pages, make sure the check box is selected (not advised if you share your computer with anyone).

Finishing the Installation Process

• Site Preferences

When you first login, you will be taken to the Preferences Subtab panel in the administration area. There you will need to set your site preferences and default settings for how Textpattern should manage Comments by default. You should set your site preferences right away.

设置一些你网站的基本信息，比如使用的语言，网站的名称等等。

• Diagnostics

After setting your preferences, you should visit the Diagnostics Subtab panel where you will be presented with some helpful diagnostics information to help troubleshoot any installation/setup problems. Details about various diagnostic notices you might see are provided in the Diagnostics Subtab documentation.

• Removing Unneccessary Files

There are certain files you should remove from your installation once you have successfully installed (or upgraded, or updated) Textpattern on your server. Discussion of these files is provided in Post Installation, Upgrading, Updating Suggestions.

Retrieved from “http://textbook.textpattern.net/wiki/index.php?title=Detailed_Installation_Instructions”