practical liferay Java -based Portal Applications development apress phần 7 pot

Chapter 7 ■  ESTABLISHING A WIKI 193

Delete

Clicking the Delete option under Advanced Actions deletes the current page after the applica￾tion asks for your confirmation to do so.

Now that you’ve seen the various general properties and actions, take a look at the next

option tab: History.

History

The History page-properties option displays the history of all your edits to the current page.

Each time you edit a page and save it, the Wiki application assigns a new version number to

the page. Both the original and revised pages are saved under their respective version num￾bers. Rather than saving the full page, the Wiki application saves only the changes made to the

page. You can always request to see the changes made between each version (see the “Com￾paring Versions” section following the “Viewing” section). First, let’s look at how to display the

different versions of a selected page.

Viewing

When you select the History tab, you see the screen shown in Figure 7-22.

Figure 7-22. A page-revision history

As you can see in Figure 7-22, the screen displays a list of all different versions of the page.

For each entry, you’ll see the following information:

• Page: This displays the page name.

• Revision: This shows the revision number.

194 Chapter 7 ■  ESTABLISHING A WIKI

• User: This shows the person who revised the page.

• Date: This shows the date and time of revision.

• Summary: This shows the summary of changes made with respect to the previous

version.

Also note the Revert button to the right of each entry. It allows you to revert your wiki page

back to the selected version.

nNote A page edit might involve changing the page name itself. This, however, would not be reflected

in the revision history. When you look up the revision history under the new page name, you would see the

entire history of the earlier edits to the page.

Comparing Versions

As you saw in the preceding “Viewing” section, the Summary column summarizes the changes

you have made to a page. You can get more information about the changes by asking for a

detailed comparison between versions. To do so, perform the following steps:

1. Select the two versions that you want to compare by marking the corresponding check

boxes on the History page.

2. Click the Compare Versions button to display the detailed list of changes in the window.

A typical comparison is shown in Figure 7-23.

Figure 7-23. Comparing revisions to a page

Creating Page Links

Now you will examine the links to and from a wiki page by using the Incoming Links and Out￾going Links tabs. A page can have both incoming and outgoing links. But before you look at the

Chapter 7 ■  ESTABLISHING A WIKI 195

display of these links, you need to create a few first. Follow these steps to add a few pages and

to create interconnecting links:

1. Open the FrontPage page for editing.

2. You must use Creole syntax for editing, so confirm that you are in Creole mode.

3. Add a link by typing [[Fundamental Analysis Research]] in the editor’s body-text win￾dow. This would create a link to the page called Fundamental Analysis Research after

you save your edits—if that page were to exist. But you do not have a page with this

name, so the application creates the link and shows it in red. Clicking this link opens

the new document in which you can add your contents. Save your edits.

4. Now, you will add one more link from this page (Fundamental Analysis Research) to

another new page.

5. Follow the procedure in step 3 to add a new page called Fundamental Analysis Report

with an interconnecting link between the two pages.

You have now set up the required pages and the interconnected links. You will examine

the display of these links in the next section.

Incoming Links

Open the Fundamental Analysis Research page. Click the Properties icon and select the Incom￾ing Links tab. You will see a screen similar to the one shown in Figure 7-24.

Figure 7-24. Display of incoming links to a page

Outgoing Links

The Outgoing Links option is similar to the Incoming Links option, except that it shows the

outgoing links instead. To view the outgoing links, open the FrontPage page. Click the Proper￾ties icon and select the Outgoing Links tab. You will see an outgoing link to the Fundamental

Analysis Research page.