|
|
Line 1: |
Line 1: |
| [[image:Actroid-DER 01.jpg|thumb|[Image.].  Are you human?  HUMANS is a website protocol written by humans for humans.  As of 2022, about forty percent of internet traffic was from robots. <ref><code>https://www.imperva.com/resources/reports/2022-Imperva-Bad-Bot-Report.pdf</code></ref>  Photo of the human-looking [[wikipedia:Actroid|Actroid]] robot from Osaka University in Japan. <ref><code>[[commons:category:robots]]</code></ref> <ref><code>[[commons:category:humanoid robots]]</code></ref> <ref><code>[[commons:category:gynoids]]</code></ref> <ref><code>[[commons:category:Actroid]]</code></ref> <ref><code>[[wikipedia:Actroid]]</code></ref>]] | | #redirect [[Solar System by orbit#Uranian System]] |
|
| |
|
| A "<code>[[ROBOTS|/robots.txt]]</code>" file instructs robot users how to access your website but it's also nice to have a "<code>/humans.txt</code>" file available for your human users. <ref><code>https://humanstxt.org/</code></ref>  The HUMANS ("we are people, not machines") website protocol will tell human visitors about the human(s) that built the website.
| | [[category:astronomy]] |
| | |
| == documentation ==
| |
| | |
| * [https://humanstxt.org/ <code>humans.txt</code>: We Are People, Not Machines]
| |
| | |
| == editor ==
| |
| | |
| {{webtext editor}}
| |
| | |
| == directory ==
| |
| | |
| "<code>humans.txt</code>" should be saved to the root webdirectory ("<code>/</code>") together with "<code>/robots.txt</code>", "<code>[[SITEMAP|/sitemap.txt]]</code>", and "<code>[[SECURITY|/security.txt]]</code>".
| |
| | |
| <u><code>https://www.nicolesharp.net/humans.txt</code></u>
| |
| | |
| == Nicole Sharp's Website ==
| |
| | |
| "<code>/humans.txt</code>" for <u>[[Nicole Sharp's Website]]</u>.
| |
| | |
| <code><syntaxhighlight lang="text">
| |
| /* TEAM */
| |
| Admin: Nicole Sharp
| |
| Site: https://www.nicolesharp.net/
| |
| Twitter: https://www.twitter.com/nicolesharp100/
| |
| Location: Cumberland, Allegany, Maryland, United States of America (US/USA)
| |
| | |
| /* THANKS */
| |
| Allegany.EDU: https://www.allegany.edu/
| |
| FileZilla: https://www.filezilla-project.org/
| |
| Frostburg.EDU: https://www.frostburg.edu/
| |
| GIMP: https://www.gimp.org/
| |
| Google: https://www.google.com/
| |
| HighlightJS: https://www.highlightjs.org/
| |
| HumansTXT: https://humanstxt.org/
| |
| Inkscape: https://www.inkscape.org/
| |
| IrfanView: https://www.irfanview.com/
| |
| Matomo: https://www.matomo.org/
| |
| Microsoft: https://www.microsoft.com/
| |
| Mozilla: https://www.mozilla.org/
| |
| Notepad-Plus-Plus: https://www.notepad-plus-plus.org/
| |
| Oracle: https://www.oracle.com/
| |
| PDFSAM: https://www.pdfsam.org/
| |
| PHP: https://www.php.net/
| |
| RobotsTXT: https://www.robotstxt.org/
| |
| SecurityTXT: https://www.securitytxt.org/
| |
| Sitemaps: https://www.sitemaps.org/
| |
| Sumatra PDF Reader: https://www.sumatrapdfreader.org/
| |
| W3C: https://www.w3.org/
| |
| WHATWG: https://www.whatwg.org/
| |
| Wikimedia: https://www.wikimedia.org/
| |
| Yandex: https://www.yandex.com/
| |
| | |
| /* SITE */
| |
| Last update: 2023
| |
| Language: English (EN/ENG)
| |
| Software: Microsoft Windows, Notepad-Plus-Plus, FileZilla, Matomo, Wikimedia MediaWiki, HighlightJS, PDFSAM, Sumatra PDF Reader, Inkscape, GIMP, IrfanView
| |
| </syntaxhighlight></code>
| |
| | |
| == TEAM ==
| |
| | |
| "<code>TEAM</code>" provides contact info for the human development team (you).
| |
| | |
| <pre>
| |
| /* TEAM */
| |
| Title: Name
| |
| Site: URL
| |
| Twitter: URL
| |
| Location: City, County, State, Country (ISO3166Alpha2/ISO3166Alpha3)
| |
| </pre>
| |
| | |
| I recommend including the translingual two-letter and three-letter [[wikipedia:ISO 3166|ISO 3166]] country codes for non-English speakers.
| |
| | |
| Additional URLs (uniform resource locators) to social media webprofiles can be added as desired.
| |
| | |
| == THANKS ==
| |
| | |
| "<code>THANKS</code>" gives thanks to anyone who helped you build the website.  I use this field to give thanks to organizations and corporations that have provided free software to help me build the website.
| |
| | |
| <pre>
| |
| /* THANKS */
| |
| Name: URL
| |
| Name: URL
| |
| </pre>
| |
| | |
| == SITE ==
| |
| | |
| "<code>SITE</code>" provides additional information about the website.
| |
| | |
| <pre>
| |
| /* SITE */
| |
| Last update: Year
| |
| Language: LanguageName (ISO639-1/ISO639-3)
| |
| Software: Application, Application
| |
| </pre>
| |
| | |
| "<code>Last update</code>" should be year-only to avoid confusion between whether this refers to the last update of "<code>/humans.txt</code>" or the last update of the website ("<code>/*</code>").  Content on the website may be being updated every day, but you shouldn't have to update "<code>/humans.txt</code>" that often.
| |
| | |
| I recommend including the translingual two-letter and three-letter [[wikipedia:ISO 639|ISO 639]] language codes for non-English speakers.
| |
| | |
| == comments ==
| |
| | |
| The HUMANS protocol doesn't formally specify a way to add comments.  <abbr title="cascading stylesheet">CSS</abbr>-style comment notation is already used for the section titles.  Since this is a protocol designed to be read by humans and not by machines, you should have considerable flexibility to modify the syntax of "<code>/humans.txt</code>" however you like as long as the content is understandable by humans (there is already a machine-readable "<code>/robots.txt</code>" for the bots).  If you need to add a comment, I recommend to use the same comment notation from the ROBOTS and SECURITY protocols with each comment on a new line beginning with a hash ("<code>#</code>"). <ref><code>https://www.rfc-editor.org/rfc/rfc9309</code></ref> <ref><code>https://www.rfc-editor.org/rfc/rfc9116</code></ref>
| |
| | |
| <code><pre>
| |
| # A comment.
| |
| </pre></code>
| |
| | |
| == ROBOTS ==
| |
| | |
| HUMANS can be added to the Robots Exclusion Protocol ("<code>/robots.txt</code>") as a comment ("<code>#</code>"). <ref><u><code>[[ROBOTS#SECURITY]]</code></u></ref> <ref><code>https://www.robotstxt.org/</code></ref>  An example Robots Exclusion Protocol with HUMANS is given below.
| |
| | |
| <highlight lang="robots">
| |
| User-agent: *
| |
| Disallow:
| |
| Sitemap: https://www.example.net/sitemap.txt
| |
| # Security: https://www.example.net/security.txt
| |
| # Humans: https://www.example.net/humans.txt
| |
| </highlight>
| |
| | |
| == HTML ==
| |
| | |
| Add the following LINK element inside your HEAD element.
| |
| | |
| <code><syntaxhighlight lang="html">
| |
| <link rel="author" type="text/plain" href="/humans.txt" />
| |
| </syntaxhighlight></code>
| |
| | |
| I use the following elements for author attribution of my HTML (hypertext markup language) pages.
| |
| | |
| <code><syntaxhighlight lang="html">
| |
| <meta name="author" content="Nicole Sharp" />
| |
| <link rel="author" type="text/html" href="/wiki/Nicole_Sharp" />
| |
| <link rel="author" type="text/plain" href="/humans.txt" />
| |
| </syntaxhighlight></code>
| |
| | |
| == MediaWiki ==
| |
| | |
| === HeadScript ===
| |
| | |
| On [[mw:Main Page|Wikimedia MediaWiki]], elements for author attribution are added to "<code>LocalSettings.php</code>" using [[mw:HeadScript|HeadScript]].
| |
| | |
| <code><syntaxhighlight lang="php">
| |
| wfLoadExtension( 'HeadScript' );
| |
| $wgHeadScriptCode = <<<'START_END_MARKER'
| |
| <meta name="author" content="Nicole Sharp" />
| |
| <link rel="author" type="text/html" href="/wiki/Nicole_Sharp" />
| |
| <link rel="author" type="text/plain" href="/humans.txt" />
| |
| START_END_MARKER;
| |
| # https://www.mediawiki.org/wiki/Extension:HeadScript
| |
| </syntaxhighlight></code>
| |
| | |
| === footer ===
| |
| | |
| To add the "<code>humans.txt</code>" [[mw:$wgFooterIcons|footer icon]] to MediaWiki, add the following to "<code>LocalSettings.php</code>" after copying the icon to "<code>/w/resources/assets/</code>".
| |
| | |
| <code><syntaxhighlight lang="php">
| |
| $wgFooterIcons['poweredby']['myicon'] = [
| |
| "src" => "$wgResourceBasePath/resources/assets/humanstxt-cc-by-nc-sa.gif",
| |
| "url" => "/humans.txt",
| |
| "alt" => "HUMANS.TXT",
| |
| ];
| |
| # https://www.mediawiki.org/wiki/$wgFooterIcons
| |
| </syntaxhighlight></code>
| |
| | |
| You can also replace <code>"$wgResourceBasePath/resources/assets/humanstxt-cc-by-nc-sa.gif"</code> with either of the following links.  This is not recommended and you should load the icon locally if possible.
| |
| * <code>"https://humanstxt.org/img/oficial-logos/humanstxt-isolated-blank.gif"</code>
| |
| * <code>"https://www.nicolesharp.net/images/humanstxt-cc-by-nc-sa.gif"</code>
| |
| | |
| Note that the "<code>humans.txt</code>" footer icon is under the [https://www.creativecommons.org/licenses/by-nc-sa/3.0/ <cite>Creative Commons Attribution-<strong class="u">NonCommercial</strong>-ShareAlike (CC BY-NC-SA) 3.0 Unported License</cite>] so this icon cannot be used on commercial or for-profit websites.  To avoid any confusion about this license, which is <em>not</em> compatible for use on [https://www.wikimedia.org/ Wikimedia] sites (despite being nonprofit), you should make sure that "<code>cc-by-nc-sa</code>" is in the filename itself so that the license stays attached to the filename if the file is downloaded or copied.
| |
| | |
| == see also ==
| |
| | |
| * <u><code>https://www.nicolesharp.net/humans.txt</code></u>
| |
| * <code>https://humanstxt.org/</code>
| |
| * <u><code>[[SECURITY]]</code></u>
| |
| * <u><code>[[ROBOTS#SECURITY]]</code></u>
| |
| | |
| == references ==
| |
| | |
| <references />
| |
| | |
| == keywords ==
| |
| | |
| <code>development, HUMANS, humans.txt, ROBOTS, robots.txt, TXT, webdevelopment</code>
| |
| | |
| {{#seo:|keywords=development, HUMANS, humans.txt, ROBOTS, robots.txt, TXT, webdevelopment}}
| |
| | |
| [[category:webdevelopment]] | |