plushpuffin's newspro garden: NewsCat ][ : Edit profile addonstatic

Name of generated text file (i.e. addonstatic.txt):

Absolute path of directory in which files will be created, with no trailing slash (i.e. /home/plushpuffin/public_html):

Include only news from categories: (multiple selections allowed)

To make multiple selections: Windows users hold down CTRL, Mac users hold down Option, most UNIX users hold down CTRL, users of other operating systems see your browser's help.


Do not include news older than days (to disable filtering by date, enter a large number 10000).

Include a maximum of news items (to disable filtering by item number, enter a large number like 10000).

Skip first news items after filtering. (to disable, enter a value of 0).

EXPERT USERS ONLY! @NewsData filtering sub. Most users should leave this blank.

Generate news using ndisplay.pl subroutine (i.e. DoNewsHTML for the general news style, DoHeadlineHTML for headlines).

Generate HTML file using .tmpl file located in your NewsPro directory (to disable HTML file creation, leave blank).
If generating HTML file, enter the file extension to use: (i.e. "html" or "htm" for HTML files, or "shtml" to use SSI).

If generating HTML file, enter page title:
Create <a name> tags with news? Unless you're going to be including more than one news file on a single HTML page, you should leave this on.
  • base URL to use in subroutines for this profile. (can be used as the variable $baseURL)
    this variable is provided for your convenience, and is especially useful when creating an index file linking to static pages
    use http://www.mysite.com/folder if referencing files located at http://www.mysite.com/folder/filename.html (no trailing backslash)
  • NewCat ][ Help on BaseURL : want an explanation of this?


Static Page Options

Static page options.
    no static pages (normal).
    static pages.
    split static pages at <PR> tags.
    slice static pages at selected field
    create an index file for sliced static pages, sorted alphabetically by slicefield value.
    create an index file for sliced static pages, sorted numerically by slicefield value.
  • NewCat ][ Help on Static Pages : want an explanation of this?
    If you choose "split static pages at <PR> tags"...
  • Put the tag <PR> (uppercase or lowercase - it doesn't matter) in your news text.
    Your news will be split at the exact locations of these tags into several files.
  • you can refer to the previous and next page in your DoNews subroutine with $prevhref and $nexthref.
    $prevhref will be blank on the first page, and $nexthref will be blank on the last page.
  • The current file name can be accessed using the variable $FileName.
  • NewCat ][ Help on Split Static Pages : want an explanation of this?

    If you choose "sliced static pages" then your sliced static pages will contain all news items with an identical "slice field" on the same page.
  • pages will be named according to the slice field.
  • eg: if you choose slice field: newssubject then all news items with a news subject of "News Flash" will be built to the page "NewsFlash.html", and all news items with a news subject of "Sports News" will be built to the page "SportsNews.html"
  • NewCat ][ Help on Sliced Static Pages : want an explanation of this?
  • The "slice field" can be selected below.
    If you choose "index of sliced pages" then this profile will create an index file of all the sliced static pages.
  • It is recommended that you customize the DoSliceIndexHTML subroutine included at the top of the npa_newscat2.pl file, and choose DoSliceIndexHTML as the news generating subroutine. You can also copy it over into ndisplay.pl and rename it if you like.
  • Your slice index HTML will be fairly simple and should look something like this:
    <a href="NewsFlash.html">News Flash</a>
    <a href="SportsNews.html">Sports News</a>
  • To ensure consistency and avoid broken links, make sure this profile is similar to the sliced profile (in terms of categories included, filtering subroutine used, etc).

Static Page Name and Slice Field selection

Select the field to use when generating the static page's file name: (only relevant when creating each news item on its own page, or when linking to static pages from another profile, or when choosing the "slice field")
Auto-rebuild static pages when news is submitted or modified? This will only rebuild/create static pages that need to be rebuilt/created. Very efficient, highly recommended. This does not rebuild sliced pages. Please note that if this option is set to "Yes", and you manually delete static pages or whatever, you must then force a total rebuild in order to recreate the pages. Essentially, setting this option will cause this static-page-profile to rebuild on submit-save/modify-save and NOT during Build News. If this option is set to "No", then this profile will build normally.

for use with split-static-pages only : Template-Per-Page

    If you like, you can specify a different template to use for every page.
  • The default template for this profile will be used for the first page.
  • In the following text field you should list the templates you wish to use for every subsequent page.
  • Separate the file names with semicolons.
  • If a news item has more pages than templates, the last template listed will be used for the remaining pages.

for use with split-static-pages only : Subroutine-Per-Page

    If you like, you can specify a different subroutine to use for every page.
  • The default subroutine for this profile will be used for the first page.
  • In the following text field you should list the subroutines you wish to use for every subsequent page.
  • Separate the subroutine names with semicolons.
  • If a news item has more pages than subroutines, the last subroutine listed will be used for the remaining pages.



online help


NewsPro 3.7.5