SitePoint Sponsor

User Tag List

Results 1 to 9 of 9

Thread: humans.txt

  1. #1
    Keep Moving Forward gold trophysilver trophybronze trophy
    Shaun(OfTheDead)'s Avatar
    Join Date
    Nov 2005
    Location
    Trinidad
    Posts
    3,727
    Mentioned
    43 Post(s)
    Tagged
    0 Thread(s)

    humans.txt

    So here's one for you.

    I've been reviewing my standard meta tags today, prior to 2014, removing the outdated ones and adding new ones like viewport, Facebook's Open Graph and Twitter's.

    When I got to my author meta tag though, I had a semantic conundrum. Customarily I'd use this tag to sign myself as being the coder of the webpage, but I realised that the tag should be better suited to credit the author of the copy.

    Some googling lead me to a site with an interesting idea on how to credit everyone involved in a website. They'd like to start the practice of creating a humans.txt file, linked in the metadata, where all contributors can be listed. Here, have a look!

    I'll be trying it out on my next website.

    I love the idea and the objective, although I feel the implementation is a little clunky.

    What do you think of this idea?

    Do you think it would catch on?
    Trying to fill the unforgiving minute
    with sixty seconds' worth of distance run.

    Update on Sitepoint's Migration to Discourse

  2. #2
    Programming Team silver trophybronze trophy
    Mittineague's Avatar
    Join Date
    Jul 2005
    Location
    West Springfield, Massachusetts
    Posts
    16,454
    Mentioned
    160 Post(s)
    Tagged
    1 Thread(s)
    I like it. Whether or not it catches on, who knows? Seems many have an aversion to spending time and effort on documentation.

    I'm sure if it does catch on the standards will evolve.

    The only thing I've seen remotely like this is gettext PO headers http://www.gnu.org/software/gettext/...der-Entry.html
    And even then, many of the language files I've seen don't follow a consistent syntax and even omit some entirely.

  3. #3
    It's all Geek to me silver trophybronze trophy
    ralph.m's Avatar
    Join Date
    Mar 2009
    Location
    Melbourne, AU
    Posts
    23,598
    Mentioned
    411 Post(s)
    Tagged
    6 Thread(s)
    It's a nice idea. I might try that too.

    Off Topic:

    Funny how the word 'humans' sounds weirder and weirder the more you say it.

  4. #4
    SitePoint Evangelist silver trophybronze trophy
    Join Date
    Jul 2013
    Posts
    406
    Mentioned
    21 Post(s)
    Tagged
    0 Thread(s)
    Quote Originally Posted by Shaun(OfTheDead) View Post
    (...) how to credit everyone involved in a website. They'd like to start the practice of creating a humans.txt file, linked in the metadata, where all contributors can be listed. Here, have a look!
    (...) What do you think of this idea? Do you think it would catch on?
    Well, I think .. in fact it is the Colophon of the site.

    So why not create a colophon page, that can be linked to the "site made by ..." link which is often at the bottom of the (home) page?
    Instead of directly pointing to the site of the webmaker, it can go to the colophon page: were (among others) the link to the webmaker's company can be included, and of the photographer(s), copywriters, etc.
    Better for SEO and PR (public relations in this case) too!

    Such a colophon page can be as simple as the txt-file above, but then as html-file so links can be clicked; it can get more attention if it's in the design of the site.
    And you can make it as attractive as you want.
    • Example: colophon page.
      Here it is the colophon of an exposition *), but this kind of things can be made for a site as well.

    _______
    *) Dutch title means: "Sparks for a fire".

    Edit
    Oops, example was made some years ago, working in FF and IE7 at that time; doesn't work in Chrome now...

  5. #5
    SitePoint Evangelist silver trophybronze trophy
    Join Date
    Jul 2013
    Posts
    406
    Mentioned
    21 Post(s)
    Tagged
    0 Thread(s)
    Edit Edit
    Oops oops, lack of short memory. - Forgotten I had disabled js in Chrome yesterday for testing an other page. Chrome is ok!
    For the list "Stupid mistakes we all made sometimes".
    Shall we make a topic for that?

    But lesson 1 in Javascript is (as I often say): "Javascript has to be unobtrusive: The page should work without javascript too".
    Repaired!

  6. #6
    Keep Moving Forward gold trophysilver trophybronze trophy
    Shaun(OfTheDead)'s Avatar
    Join Date
    Nov 2005
    Location
    Trinidad
    Posts
    3,727
    Mentioned
    43 Post(s)
    Tagged
    0 Thread(s)
    It looks like the practice is already pretty popular.

    Check this out: http://www.google.com/humans.txt

    There're online generators: http://humanstxt-creator.org/

    And Wordpress plugins too. I just did a web search and got three million results.
    Trying to fill the unforgiving minute
    with sixty seconds' worth of distance run.

    Update on Sitepoint's Migration to Discourse

  7. #7
    Keep Moving Forward gold trophysilver trophybronze trophy
    Shaun(OfTheDead)'s Avatar
    Join Date
    Nov 2005
    Location
    Trinidad
    Posts
    3,727
    Mentioned
    43 Post(s)
    Tagged
    0 Thread(s)
    Quote Originally Posted by Francky View Post
    Well, I think .. in fact it is the Colophon of the site.
    I didn't even know 'colophon' was a word!
    Trying to fill the unforgiving minute
    with sixty seconds' worth of distance run.

    Update on Sitepoint's Migration to Discourse

  8. #8
    SitePoint Evangelist silver trophybronze trophy
    Join Date
    Jul 2013
    Posts
    406
    Mentioned
    21 Post(s)
    Tagged
    0 Thread(s)
    Quote Originally Posted by Shaun(OfTheDead) View Post
    I didn't even know 'colophon' was a word!
    The word "colophon" is coming from the publishing world. This example is pretty like a humans.text.
    In books, the colophon often includes the copyright notice.
    See: en.wikipedia.org/wiki/Colophon_(publishing) and some beautiful examples in the images tab of google.com/search?q=example+colophon+page.

    Maybe the word "imprint" is more common in English (it's not my native language).


    I think this way is more telling than the google.com/humans.txt, and more user friendly than this github.com/humans.txt.

    In Germany the humans.txt/colophon/imprint is called "Impressum", and for websites it's even a legally mandated statement:
    • "The Telemediengesetz ('Telemedia Act') requires that German websites must disclose information about the publisher, including their name and address, telephone number or e-mail address, trade registry number, VAT number, and other information depending on the type of company.
      German websites are defined as being published by individuals or organisations that are based in Germany, so an Impressum is required regardless of whether a site is in the .de domain." (en.wikipedia.org/wiki/Impressum)
    • As far as I know, German websites do it always in a normal webpage (for instance messefrankfurt.com/.../impressum)

  9. #9
    SitePoint Member
    Join Date
    Dec 2013
    Posts
    3
    Mentioned
    0 Post(s)
    Tagged
    0 Thread(s)
    Quote Originally Posted by Shaun(OfTheDead) View Post
    Snip
    It's a good practice, and something I was unaware of until now.

    Quote Originally Posted by Francky View Post
    Snip
    (And) Now I have a new word to use, abuse and make use of.

    Quote Originally Posted by Francky View Post
    In Germany the humans.txt/colophon/imprint is called "Impressum", and for websites it's even a legally mandated statement:
    • "The Telemediengesetz ('Telemedia Act') requires that German websites must disclose information about the publisher, including their name and address, telephone number or e-mail address, trade registry number, VAT number, and other information depending on the type of company.
      German websites are defined as being published by individuals or organisations that are based in Germany, so an Impressum is required regardless of whether a site is in the .de domain." (en.wikipedia.org/wiki/Impressum)
    • As far as I know, German websites do it always in a normal webpage (for instance messefrankfurt.com/.../impressum)
    This is good good to know, Francky. Thank's for passing this on ... I may be just getting my feet wet in the Web Development world, but I might as well make it a habit to put this into practice.


Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •