97 lines
7.2 KiB
EmacsLisp
97 lines
7.2 KiB
EmacsLisp
|
;;; http-relations.el --- Look up the meaning of HTTP relations
|
|||
|
;;
|
|||
|
;; This file was automatically generated by
|
|||
|
;; https://github.com/for-GET/know-your-http-well
|
|||
|
;;
|
|||
|
;;; Commentary:
|
|||
|
;;; Code goes here:
|
|||
|
|
|||
|
(defconst http-relations
|
|||
|
'(("about" ("Refers to a resource that is the subject of the link's context."))
|
|||
|
("alternate" ("Refers to a substitute for this context"))
|
|||
|
("appendix" ("Refers to an appendix."))
|
|||
|
("archives" ("Refers to a collection of records, documents, or other materials of historical interest."))
|
|||
|
("author" ("Refers to the context's author."))
|
|||
|
("bookmark" ("Gives a permanent link to use for bookmarking purposes."))
|
|||
|
("canonical" ("Designates the preferred version of a resource (the IRI and its contents)."))
|
|||
|
("chapter" ("Refers to a chapter in a collection of resources."))
|
|||
|
("collection" ("The target IRI points to a resource which represents the collection resource for the context IRI."))
|
|||
|
("contents" ("Refers to a table of contents."))
|
|||
|
("copyright" ("Refers to a copyright statement that applies to the link's context."))
|
|||
|
("create-form" ("The target IRI points to a resource where a submission form can be obtained."))
|
|||
|
("current" ("Refers to a resource containing the most recent item(s) in a collection of resources."))
|
|||
|
("describedby" ("Refers to a resource providing information about the link's context."))
|
|||
|
("describes" ("The relationship A 'describes' B asserts that resource A provides a description of resource B. There are no constraints on the format or representation of either A or B, neither are there any further constraints on either resource."))
|
|||
|
("disclosure" ("Refers to a list of patent disclosures made with respect to material for which `disclosure` relation is specified."))
|
|||
|
("duplicate" ("Refers to a resource whose available representations are byte-for-byte identical with the corresponding representations of the context IRI."))
|
|||
|
("edit" ("Refers to a resource that can be used to edit the link's context."))
|
|||
|
("edit-form" ("The target IRI points to a resource where a submission form for editing associated resource can be obtained."))
|
|||
|
("edit-media" ("Refers to a resource that can be used to edit media associated with the link's context."))
|
|||
|
("enclosure" ("Identifies a related resource that is potentially large and might require special handling."))
|
|||
|
("first" ("An IRI that refers to the furthest preceding resource in a series of resources."))
|
|||
|
("glossary" ("Refers to a glossary of terms."))
|
|||
|
("help" ("Refers to context-sensitive help."))
|
|||
|
("hosts" ("Refers to a resource hosted by the server indicated by the link context."))
|
|||
|
("hub" ("Refers to a hub that enables registration for notification of updates to the context."))
|
|||
|
("icon" ("Refers to an icon representing the link's context."))
|
|||
|
("index" ("Refers to an index."))
|
|||
|
("item" ("The target IRI points to a resource that is a member of the collection represented by the context IRI."))
|
|||
|
("last" ("An IRI that refers to the furthest following resource in a series of resources."))
|
|||
|
("latest-version" ("Points to a resource containing the latest (e.g., current) version of the context."))
|
|||
|
("license" ("Refers to a license associated with this context."))
|
|||
|
("lrdd" ("Refers to further information about the link's context, expressed as a LRDD (Link-based Resource Descriptor Document) resource. See [RFC6415](https://tools.ietf.org/html/rfc6415) for information about processing this relation type in host-meta documents. When used elsewhere, it refers to additional links and other metadata. Multiple instances indicate additional LRDD resources. LRDD resources MUST have an application/xrd+xml representation, and MAY have others."))
|
|||
|
("monitor" ("Refers to a resource that can be used to monitor changes in an HTTP resource."))
|
|||
|
("monitor-group" ("Refers to a resource that can be used to monitor changes in a specified group of HTTP resources."))
|
|||
|
("next" ("Indicates that the link's context is a part of a series, and that the next in the series is the link target."))
|
|||
|
("next-archive" ("Refers to the immediately following archive resource."))
|
|||
|
("nofollow" ("Indicates that the context’s original author or publisher does not endorse the link target."))
|
|||
|
("noreferrer" ("Indicates that no referrer information is to be leaked when following the link."))
|
|||
|
("payment" ("Indicates a resource where payment is accepted."))
|
|||
|
("predecessor-version" ("Points to a resource containing the predecessor version in the version history."))
|
|||
|
("prefetch" ("Indicates that the link target should be preemptively cached."))
|
|||
|
("prev" ("Indicates that the link's context is a part of a series, and that the previous in the series is the link target."))
|
|||
|
("preview" ("Refers to a resource that provides a preview of the link's context."))
|
|||
|
("previous" ("Refers to the previous resource in an ordered series of resources. Synonym for `prev`."))
|
|||
|
("prev-archive" ("Refers to the immediately preceding archive resource."))
|
|||
|
("privacy-policy" ("Refers to a privacy policy associated with the link's context."))
|
|||
|
("profile" ("Identifying that a resource representation conforms to a certain profile, without affecting the non-profile semantics of the resource representation"))
|
|||
|
("related" ("Identifies a related resource."))
|
|||
|
("replies" ("Identifies a resource that is a reply to the context of the link."))
|
|||
|
("search" ("Refers to a resource that can be used to search through the link's context and related resources."))
|
|||
|
("section" ("Refers to a section in a collection of resources."))
|
|||
|
("self" ("Conveys an identifier for the link's context."))
|
|||
|
("service" ("Indicates a URI that can be used to retrieve a service document."))
|
|||
|
("start" ("Refers to the first resource in a collection of resources."))
|
|||
|
("stylesheet" ("Refers to a stylesheet."))
|
|||
|
("subsection" ("Refers to a resource serving as a subsection in a collection of resources."))
|
|||
|
("successor-version" ("Points to a resource containing the successor version in the version history."))
|
|||
|
("tag" ("Gives a tag (identified by the given address) that applies to the current document."))
|
|||
|
("terms-of-service" ("Refers to the terms of service associated with the link's context."))
|
|||
|
("type" ("Refers to a resource identifying the abstract semantic type of which the link's context is considered to be an instance."))
|
|||
|
("up" ("Refers to a parent document in a hierarchy of documents."))
|
|||
|
("version-history" ("Points to a resource containing the version history for the context."))
|
|||
|
("via" ("Identifies a resource that is the source of the information in the link's context."))
|
|||
|
("working-copy" ("Points to a working copy for this resource."))
|
|||
|
("working-copy-of" ("Points to the versioned resource from which this working copy was obtained."))
|
|||
|
("blocked-by" ("Identifies the entity blocking access to a resource folllowing on receipt of a legal demand."))))
|
|||
|
|
|||
|
;;;###autoload
|
|||
|
(defun http-relation (relation)
|
|||
|
"Display the meaning of an HTTP relation"
|
|||
|
(interactive
|
|||
|
(list (completing-read "Enter HTTP relation: " http-relations)))
|
|||
|
(let* ((lowercased-relation (downcase relation))
|
|||
|
(found (assoc lowercased-relation http-relations)))
|
|||
|
(if found
|
|||
|
(let ((description (car (cdr found))))
|
|||
|
(message
|
|||
|
"%s - HTTP relation\n%s"
|
|||
|
lowercased-relation (car description) ))
|
|||
|
(message "%s - HTTP relation\nUNKNOWN" lowercased-relation))
|
|||
|
))
|
|||
|
|
|||
|
(provide 'http-relations)
|
|||
|
|
|||
|
;;; http-relation.el ends here
|
|||
|
|