depend-examples: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edit of CfaFg5, changed back to last version by DerrickPallas)
Line 103: Line 103:
* <h3>Runtime Dependencies</h3> dependencies published using <div
* <h3>Runtime Dependencies</h3> dependencies published using <div
class="depbox with links.
class="depbox with links.
*
* &gt;= <a href="/dev-lang/perl">dev-lang/perl</a>-5.6.1
* the previous behaviour is used for each version of the published software
Lots of semantic html.  Could be clues for possibles property names.
 
== See Also ==
* [[rel-tag]] (for language, etc.)
* [[rel-license]]
* [[hcard hCard]] (for authors)
 
* [[http://usefulinc.com/doap/ DOAP]] (similar in nature)

Revision as of 14:51, 9 July 2007

depend examples

Overview

This page is dedicated to fleshing out examples of dependency (software and otherwise) on the Web-At-Large.

Authors

Motivation

Right now, there many ways to install software; whether you're using binaries (apt-get, yum, rpm) or source (emerge, srpm, *-src), you have to go through a clearing house. Someone took the time to compile binaries or repackage source trees and write down what needed what.

But the fact is all of this information is already on the homepage for most software. Current aggregators rely on the author(s) submitting this information manually. Furthermore, commercial packages don't normally submit product information to sites like FreshMeat, SourceForge, or any language-specific repository (CPAN, PEAR). (This includes things like drivers.)

Because the information (version, dependency, package URLs, bug alerts) is already there (see below) it should be fairly straight-forward to figure out what people already do and "semantic it up."

Examples

Linux Kernel

http://kernel.org/

  • uses <link> to provide RSS feed
  • uses word "versions"
  • uses links to deliverable with version string as anchor text
  • uses a kind of "product/software id" (my made up term) to identify the thing being described
  • includes a description of the software
  • includes the date published
  • uses keywords as anchor text to perform operations or view
  • additional features. for example, V for view diff, changelog to see the changelog, etc...

    libPNG

    http://libpng.org/pub/png/libpng.html

    Interesting. "made by "his guy" :-) . hcard would seem to be a perfect fit here.

    • libpng name of software in an element
    • <A HREF=

    "http://libpng.sourceforge.net/">http://libpng.sourceforge.net/</A> link to homepage

    • requires zlib 1.0.4

    or later (1.2.3 or 1.1.4 lossy markup of requirements

    • The current public release, libpng 1.2.15 again, lossy markup
    • includes a description of the software
    • libpng 1.2.12 another mention of the software in it's own element
    • the site contains links to test suites, documentation, and download links
    • also includes a description of how to verify the contents
    • lots of content about the software, but very little semantic markup.

    good example: easy to see how some semantic techniques would help. would marking this up using hatom help at all?

    libvc

    http://freshmeat.net/projects/libvc/

    • uses <link> to an rss feed
    • links to other project areas... issue tracking, forums etc...
    • branch info published
    • date added, created, modified all published
    • description
    • author
    • "trove" categories
    • might list dependencies, but there are none for this particular example
    • stats listed: vitality, popularity, downloads, graphs...
    • hits, subscribers
    • other projects depending on this one are listed
    • license published
    • download links provided
    • no semantic markup present.

    Ruby FastCGI

    http://raa.ruby-lang.org/project/fcgi/

    • <link> and <meta> used to convey authorship, "made", author, and

    some other attributes: search, index, home, glossary

    • interesting, there is some semantic html...

    fcgi / 0.8.7

    • key value pairs (in a table) for: short description, category,
    status, created, last update, owner, homepage, download, source vieweing, license, dependency, versions as link text to the deliverable with date published outside the link
    • uses address to list contact for the document, and other uses of
    semantic html such as class names "footer", "header", and "caption". Shows a receptivity to semantic techniques as well as confirming the list of properties published by software vendors.

    Portage: dev-lang/erlang

    http://www.gentoo-portage.com/dev-lang/erlang/Dep#ptabs

    • <link> to rss feed
    • <body id="gentoo-portage"> intended consumer published in markup
    • links to other project areas
    • dev-lang/erlang

      product name
    • used for description
      • ...
      used to list project websites
      • ... used for consumer-specific parameters
      • "view" and "download" links.
      • Runtime Dependencies

        dependencies published using <div

      class="depbox with links.

      • >= <a href="/dev-lang/perl">dev-lang/perl</a>-5.6.1
      • the previous behaviour is used for each version of the published software

      Lots of semantic html. Could be clues for possibles property names.

      See Also

      • [DOAP] (similar in nature)