Derby
  1. Derby
  2. DERBY-5383

Add articles and blog links to the site's Resources tab

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: 10.9.1.0
    • Fix Version/s: 10.9.1.0
    • Component/s: Web Site
    • Labels:
      None

      Description

      It would be nice to add some links to stuff people have authored about Derby/Java DB and provide easy access to those in the Resources tab. I have collected some and intend to add a new page with such links.

      1. sitepatch-2.stat
        4 kB
        Dag H. Wanvik
      2. sitepatch-2.diff.gz
        23 kB
        Dag H. Wanvik
      3. sitepatch.stat
        4 kB
        Dag H. Wanvik
      4. sitepatch.diff.gz
        169 kB
        Dag H. Wanvik
      5. off.jpg
        18 kB
        Dag H. Wanvik

        Activity

        Hide
        Dag H. Wanvik added a comment -

        Uploading a patch with a new menu item in the resources tab: "Blogs and articles about Derby". Note: the diffs include the generated HTML files, so applying the patch shoudl allow you to view the result without running forrest. Note you need to drop the binary off.jpg into the folder "src/documentation/content/xdocs/blogs" (the diff doesn't capture the binary). We may not be able to use the binary, though, not sure..

        Show
        Dag H. Wanvik added a comment - Uploading a patch with a new menu item in the resources tab: "Blogs and articles about Derby". Note: the diffs include the generated HTML files, so applying the patch shoudl allow you to view the result without running forrest. Note you need to drop the binary off.jpg into the folder "src/documentation/content/xdocs/blogs" (the diff doesn't capture the binary). We may not be able to use the binary, though, not sure..
        Hide
        Rick Hillegas added a comment -

        Thanks for adding these resources to the website, Dag. Overall, this looks great. A couple comments:

        1) The html output under build/site/blogs was not included when I applied the patch. However, it turned up after I built the website.

        2) When I click on the Resources tab and expand "Blogs and Articles About Derby" in the left pane, I notice that clicking on the drill-down links takes me to the "Blogs and articles about Derby" page but I am not positioned inside the page on the correct headings. So, for instance, if I click on Articles->Tools and Migration->Tools, I am taken to the "Blogs and articles about Derby" page but I am not positioned on the "Tools" section. If I click the "Tools" link inside the page, then I am taken to the right place.

        Thanks,
        -Rick

        Show
        Rick Hillegas added a comment - Thanks for adding these resources to the website, Dag. Overall, this looks great. A couple comments: 1) The html output under build/site/blogs was not included when I applied the patch. However, it turned up after I built the website. 2) When I click on the Resources tab and expand "Blogs and Articles About Derby" in the left pane, I notice that clicking on the drill-down links takes me to the "Blogs and articles about Derby" page but I am not positioned inside the page on the correct headings. So, for instance, if I click on Articles->Tools and Migration->Tools, I am taken to the "Blogs and articles about Derby" page but I am not positioned on the "Tools" section. If I click the "Tools" link inside the page, then I am taken to the right place. Thanks, -Rick
        Hide
        Dag H. Wanvik added a comment -

        Thanks for looking at the patch, Rick. I'll look into why the build/site/blogs wasn't included in the patch, maybe there is an ignore on them? In any case, the site should be built eventually in the checkout location of the site, so I guess that's ok. As for the positioning, I saw that too. I followed the pre-existing approach on this, I am not sure why the positioning isn't great there (it takes you to the right page, but not the right section. In any case, the toc is easy enough to use once you are there..) Any idea of how to fix this?

        Show
        Dag H. Wanvik added a comment - Thanks for looking at the patch, Rick. I'll look into why the build/site/blogs wasn't included in the patch, maybe there is an ignore on them? In any case, the site should be built eventually in the checkout location of the site, so I guess that's ok. As for the positioning, I saw that too. I followed the pre-existing approach on this, I am not sure why the positioning isn't great there (it takes you to the right page, but not the right section. In any case, the toc is easy enough to use once you are there..) Any idea of how to fix this?
        Hide
        Rick Hillegas added a comment -

        Hi Dag,

        One thing I notice about the other TOC entries in the left panel of the Resources tab is this: none of the others have links to anchors inside other pages. They just link to the pages without anchors. The generated html for the broken links looks odd to me. The hrefs contain multiple # separators. E.g.:

        <a href="../blogs/index.html#articlesindex.html#toolsetcindex.html#tools">Tools</a>

        Don't know enough about Forrest/Cocoon to give advice here.

        Show
        Rick Hillegas added a comment - Hi Dag, One thing I notice about the other TOC entries in the left panel of the Resources tab is this: none of the others have links to anchors inside other pages. They just link to the pages without anchors. The generated html for the broken links looks odd to me. The hrefs contain multiple # separators. E.g.: <a href="../blogs/index.html#articlesindex.html#toolsetcindex.html#tools">Tools</a> Don't know enough about Forrest/Cocoon to give advice here.
        Hide
        Dag H. Wanvik added a comment - - edited

        Yes, I realized I could cut up the file into several to side-step the issue, but I wanted to keep all the news tuff in a single file for ease of browsing them all. But since the menu links are broken, I may end up splitting the file into pieces to make the menu links work, or just omit the menu links (in the left menu). Which would you prefer?

        Show
        Dag H. Wanvik added a comment - - edited Yes, I realized I could cut up the file into several to side-step the issue, but I wanted to keep all the news tuff in a single file for ease of browsing them all. But since the menu links are broken, I may end up splitting the file into pieces to make the menu links work, or just omit the menu links (in the left menu). Which would you prefer?
        Hide
        Rick Hillegas added a comment -

        Hi Dag,

        I don't have a strong preference either way. I like your goal of making it easy to browse the new stuff in a single file. Thanks.

        Show
        Rick Hillegas added a comment - Hi Dag, I don't have a strong preference either way. I like your goal of making it easy to browse the new stuff in a single file. Thanks.
        Hide
        Dag H. Wanvik added a comment -

        Uploading a new version of the patch. This time, the links should work, Rick. I also removed what looked like a small glitch: a remaining dangling reference to release 10.5.2 (in cli.xconf) which is no longer listed for download. I believe all the generated html files are present this time. If it looks OK, I'll commit this tomorrow.

        Show
        Dag H. Wanvik added a comment - Uploading a new version of the patch. This time, the links should work, Rick. I also removed what looked like a small glitch: a remaining dangling reference to release 10.5.2 (in cli.xconf) which is no longer listed for download. I believe all the generated html files are present this time. If it looks OK, I'll commit this tomorrow.
        Hide
        Rick Hillegas added a comment -

        Thanks, Dag. This looks great. +1

        Show
        Rick Hillegas added a comment - Thanks, Dag. This looks great. +1
        Hide
        Dag H. Wanvik added a comment -

        Committed patch #2 as svn 1164672.

        Show
        Dag H. Wanvik added a comment - Committed patch #2 as svn 1164672.
        Hide
        Knut Anders Hatlen added a comment -

        [bulk update] Close all resolved issues that haven't been updated for more than one year.

        Show
        Knut Anders Hatlen added a comment - [bulk update] Close all resolved issues that haven't been updated for more than one year.

          People

          • Assignee:
            Dag H. Wanvik
            Reporter:
            Dag H. Wanvik
          • Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development