Mailing-List: contact dev-help@jackrabbit.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@jackrabbit.apache.org
Message-ID: <284593876.1211966265097.JavaMail.jira@brutus>
Date: Wed, 28 May 2008 02:17:45 -0700 (PDT)
From: "Alexander Klimetschek (JIRA)" <jira@apache.org>
To: dev@jackrabbit.apache.org
Subject: [jira] Updated: (JCR-1628) Put HTML version of JCR spec on website
 (for search indexing)
In-Reply-To: <100086423.1211966025004.JavaMail.jira@brutus>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


     [ https://issues.apache.org/jira/browse/JCR-1628?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Alexander Klimetschek updated JCR-1628:
---------------------------------------

    Attachment: jsr-170-html.zip

This is an HTML variant of the PDF generated with pdftohtml (http://pdftohtml.sourceforge.net/). There are many files in the zip, the start page is "jsr170-jcr-1.0.html".

It contains images and preserves the layout, thus it looks really good. The problem is that it has one page per PDF and you need the page index (using frames, shown at the left) to browse through the pages. There should be at least a next and previous page on each site. Much better would be a real index by section titles, which is only present in the TOC pages at the beginning (but you don't know where these are, because the page index only says Page 1, Page 2, ...).

> Put HTML version of JCR spec on website (for search indexing)
> -------------------------------------------------------------
>
>                 Key: JCR-1628
>                 URL: https://issues.apache.org/jira/browse/JCR-1628
>             Project: Jackrabbit
>          Issue Type: New Feature
>          Components: docs
>            Reporter: Alexander Klimetschek
>         Attachments: jsr-170-html.zip
>
>
> It would be good to have the JCR spec online (starting with 1.0 now) in an HTML version. This has several benefits:
> - no need to go through the many steps needed to download the JCR 1.0 pdf from the JSR site
> - more visibility of the one-and-only documentation on JCR
> - less discussion about JCR spec parts because users can inform themselves easier than before
> - HTML content will be indexed by search engines, finding JCR information will be much better

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.