Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Higgins Specs"

(TODO)
(Higgins Data Model)
Line 25: Line 25:
 
http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-context-discovery.html?root=Technology_SVN&view=log
 
http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-context-discovery.html?root=Technology_SVN&view=log
  
=== Higgins Data Model ===
+
=== Higgins Global Graph Data Model ===
 
+
Note: The following are just experimenting with the tools. Nothing ready to look at or review.
 
'''XML file in SVN''':  
 
'''XML file in SVN''':  
 
http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-datamodel.xml?root=Technology_SVN&view=log
 
http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-datamodel.xml?root=Technology_SVN&view=log

Revision as of 13:34, 18 February 2008

This page describes an effort to create the following three Higgins Spec documents:

  • Higgins Identifiers
  • Higgins Context Discovery
  • Higgins Data Model

These are XML files that can be converted to HTML files.

Specs

Higgins Identifiers

XML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-identifiers.xml?root=Technology_SVN&view=log

HTML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-identifiers.html?root=Technology_SVN&view=log

Higgins Context Discovery

XML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-context-discovery.xml?root=Technology_SVN&view=log

HTML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-context-discovery.html?root=Technology_SVN&view=log

Higgins Global Graph Data Model

Note: The following are just experimenting with the tools. Nothing ready to look at or review. XML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-datamodel.xml?root=Technology_SVN&view=log

HTML file in SVN: http://dev.eclipse.org/viewsvn/index.cgi/org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/draft-higgins-datamodel.html?root=Technology_SVN&view=log

Editing

The three XML files are in the org.eclipse.higgins.doc project.

The complete SVN path is /org.eclipse.higgins/trunk/doc/org.eclipse.higgins.doc/Specs/.

They can the be edited using any XML or text editor. Do not edit the HTML files directly!

How to convert to HTML

In order to convert one of the XML files to HTML, the "xml2rfc" tools has to be used. Follow these steps:

  1. Go to http://xml.resource.org/
  2. Fill in the "Convert Your XML Source" form as follows:
    • Input file: Upload the XML file you want to convert here
    • Output mode: HTML
    • Output result: Window (if you just want to validate/preview your XML) or File (if you want to download the resulting HTML file)

Convert-xml-rfc.png

After you made changes to the XML file and converted it to HTML, commit both files back to the SVN.

Tips

  • The rfc2xml tool is not very forgiving. If it encounters XML elements it does not like, it throws error messages which may be hard to understand. Therefore always make sure the XML file can be converted to HTML, before committing your changes to the SVN.

TODO

  • Look through the docs and fix bugs, complete missing sections, etc. in order to produce first complete drafts
  • Determine final URLs for these docs (they reference each other by absolute URLs)
  • Decide on list of editors
  • Decide on filenames (i.e. something better than draft-higgins-identifiers.html)
  • Add additional specs?

Back to the top