Bug 979224 - web site instructions out of date
Summary: web site instructions out of date
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Publican
Classification: Community
Component: Publican Users Guide
Version: 3.1
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: 3.2
Assignee: Zac Dover
QA Contact: tools-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-06-28 01:58 UTC by Jeff Fearn 🐞
Modified: 2013-08-09 04:48 UTC (History)
5 users (show)

Fixed In Version: 3.2.0
Clone Of:
Environment:
Last Closed: 2013-08-09 04:48:45 UTC
Embargoed:


Attachments (Terms of Use)

Description Jeff Fearn 🐞 2013-06-28 01:58:12 UTC
Some steps are missing for changes introduced in 3.1. 

RPM sites:

$ yum install publican-web publican-$brand-web
$ publican update_site


For manual sites:

$ cd $brandsrc_dir (yes including the common brand in the publican source >_<)
$ publican build --formats=xml --langs=all --publish    # brands don't use embedtoc
$ publican install_brand --web --path=$path_to_site_root_dir
# repeat for all brands
$ publican update_site --site_config $path_to_site_cfg

You might want to try setting web_style in your site cfg to 2 and run update_site for a different look. This is also not in the PUG but is documented in 'publican help_config'.

$ publican help_config | grep -A3 web_style
    web_style:
        Splash pages should be generated to be compatible with this web style. Valid values are 1 and 2.
        Default: 1
        Constraint: [1-2]

Which is actually a pretty sad description given '2' is an entirely different web layout

Comment 2 Ruediger Landmann 2013-07-12 06:56:30 UTC
> $ yum install publican-web publican-$brand-web

NB publican-web is now publican-common-web

Comment 3 HSS Product Manager 2013-07-15 23:57:51 UTC
HSS-QE has reviewed and declined this request. QE for this bug will be handled by IED.

Comment 4 Zac Dover 2013-07-24 01:44:49 UTC
In section 7.2.1 "Creating the website structure", I changed
  Install Publican. For example, on a webserver with a Fedora operating 
  system, run:

  yum install publican

to

  Install Publican. For example, on a webserver with a Fedora operating 
  system, run:

  yum install publican-web publican-$brand-web


and I changed
  To make Publican refresh the site structure at any time, run:

  publican update_site --site_config /etc/publican-website.cfg

to

  To make Publican refresh the site structure at any time, run:

  publican update_site


Committed to
3435f3f..5c6d98d

Comment 5 Zac Dover 2013-07-24 04:27:40 UTC
I have added the following to "7.1.1. Creating the website structure":

 Build and install the documents in each brand.

    $cd brandsrc_dir

    $publican build --formats=xml --langs=all --publish

    $publican install_brand --web --path=path_to_site_root_dir

    Perform these steps for all brands.

    $publican update_site --site_config path_to_site_cfg

Committed to devel:
b5b512c..119213e

Comment 6 Zac Dover 2013-07-24 05:54:58 UTC
I have added the following to "4.1.1. The publican.cfg file":

web_style
    sets the web style, which determines the layout and presentation of the website. Valid values are 1 and 2. Style 1 features a navigation pane at the left side of the screen that provides access to all of the documents on the site. Style 2 offers a breadcrumb-like navigation system. 

Committed to devel:
119213e..735624d

Comment 11 Jeff Fearn 🐞 2013-08-09 04:48:45 UTC
The fix for this bug has been shipped in publican 3.2.0


Note You need to log in before you can comment on or make changes to this bug.