Bug 1267765
Summary: | Unable to add articles to manually created website in Publican 3.2 | ||
---|---|---|---|
Product: | [Community] Publican | Reporter: | Cheryl Fernandes <cheryl.fernandes> |
Component: | publican | Assignee: | Ruediger Landmann <rlandman> |
Status: | CLOSED WONTFIX | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
Severity: | high | Docs Contact: | |
Priority: | unspecified | ||
Version: | 3.2 | CC: | cbredesen, jfearn, lepata2002, me, mmcallis, rlandman |
Target Milestone: | --- | ||
Target Release: | --- | ||
Hardware: | Unspecified | ||
OS: | Other | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | Bug Fix | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2017-01-09 11:44:52 UTC | Type: | Bug |
Regression: | --- | Mount Type: | --- |
Documentation: | --- | CRM: | |
Verified Versions: | Category: | --- | |
oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
Cloudforms Team: | --- | Target Upstream Version: | |
Embargoed: |
Description
Cheryl Fernandes
2015-09-30 22:47:26 UTC
Looks like you aren't installing the book. 4.1. Install the book: publican install_book --site_config path_to_site_configuration_file.cfg --lang en-US Unfortunately this action only takes one language at a time so you need to do it in a loop. I tried the following: 1. cd into the article folder e.g. Home_Page 2. build the article publican build --publish --formats html-single --embedtoc 3. Add the article into the website. Run this command from the article folder i.e. same location where the previous command is run publican install_book --site_config <path to my sites> Actual results: The page has the word 'Products' and a search bar. Expected results: I'm expecting the article and the TOC to show up like when I create a document. In other words, these commands haven't made a difference. If it helps, I'm using Publican version 3.2. Please advise. Additionally, whenever I try to build using parameter 'embedtoc', for some reason all the styling goes away and I'm left with just the basic HTML being displayed. I have seen someone report this bug earlier but was it fixed for V3.2 and greater? Thanks for all your help. Hi Cheryl, it looks to me like you are trying to add an article before you add a home page, or you haven;t got your home page configured properly. The order of installing and configuring is critical. https://jfearn.fedorapeople.org/en-US/Publican/4.3/html/Users_Guide/chap-Publican-Users_Guide-Building_a_website_with_Publican.html#sect-Publican-Users_Guide-Building_a_website_with_Publican-Building_a_website_manually I point to the latest version of the doc not because the process has changed much, but because the docs have been improved and are more accurate as to order and configuration. 1. I followed the instructions as per V4.3 of publican. Turns out that the instructions were right and I followed them right. What was giving me trouble was the "host" property of my sites .cfg file When I would declare it like, "host: localhost", the links to the js and css files in var/www/html/docs/en-US/index.html would be, "http://localhost/docs/en-US/localhost/docs/toc.js" which results in a 404 error and that why I was only seeing the product text with the search bar. After I changed the hostname in the .cfg to, "host: ../../docs/", the links to the css and js file were, "http://localhost/docs/en-US/toc.js" which is why I can now see the menu and the content. Not sure if this is correct but this is how I got it to work. I am now facing issues with the table of contents namely the iframe with body of class="tocnav". I see the logo, the search bar and the Language dropdown with the 'collapse all' link but how do I add the article I just created namely, FooMaster and FooMaster_3 with web_type: product/version respectively to the navigation menu? Thanks for all your help so far. Description of problem: I'm using AltLinux and have Publican3.0 installed. I'm trying to build a website manually but am having trouble integrating Articles into the website. Home page installed. Steps to Reproduce: 1. Create an article using publican create --type Article --name page_name 2. cd to the page_name folder 3. Build the article using publican build --publish --formats html-single --embedtoc --langs all 4. Install the book: publican install_book --site_config path_to_site_configuration_file.cfg --lang en-US 5. Go to html/docs/en-US/ folder and open up, index.html Version-Release number of selected component (if applicable): Publican3.0 Actual results: The page has the word 'Products', a search bar, select language, home page. File .db does not change. Expected results: I'm expecting the article and menu in the TOC to show up like when I create a document. Insert in .db Additional info: None. (In reply to Cheryl Fernandes from comment #5) > 1. I followed the instructions as per V4.3 of publican. Turns out that the > instructions were right and I followed them right. What was giving me > trouble was the "host" property of my sites .cfg file > > When I would declare it like, "host: localhost", the links to the js and css > files in var/www/html/docs/en-US/index.html would be, > "http://localhost/docs/en-US/localhost/docs/toc.js" which results in a 404 > error and that why I was only seeing the product text with the search bar. > > After I changed the hostname in the .cfg to, "host: ../../docs/", the links > to the css and js file were, "http://localhost/docs/en-US/toc.js" which is > why I can now see the menu and the content. Not sure if this is correct but > this is how I got it to work. > > I am now facing issues with the table of contents namely the iframe with > body of class="tocnav". > I see the logo, the search bar and the Language dropdown with the 'collapse > all' link but how do I add the article I just created namely, FooMaster and > FooMaster_3 with web_type: product/version respectively to the navigation > menu? > Thanks for all your help so far. Hi Cheryl, I think it's the relative path in site, can you try setting "host: /docs/" (In reply to Elena Mishina from comment #6) > Description of problem: > I'm using AltLinux and have Publican3.0 installed. I'm trying to build a > website manually but am having trouble integrating Articles into the website. > > Home page installed. > > Steps to Reproduce: > 1. Create an article using publican create --type Article --name page_name > 2. cd to the page_name folder > 3. Build the article using publican build --publish --formats html-single > --embedtoc --langs all > 4. Install the book: publican install_book --site_config > path_to_site_configuration_file.cfg --lang en-US > 5. Go to html/docs/en-US/ folder and open up, index.html > > Version-Release number of selected component (if applicable): > Publican3.0 > > Actual results: > The page has the word 'Products', a search bar, select language, home page. > File .db does not change. > > Expected results: > I'm expecting the article and menu in the TOC to show up like when I create > a document. > Insert in .db > > > Additional info: > None. Hi Elenea, you probably need to run the install as root. No response. |