= Сообщение: 1942 из 3030 =================================== GANJANET.LOCAL = От : Mithgol the Webmaster 2:5063/88 10 Feb 07 13:51:44 Кому : All 10 Feb 07 13:51:44 Тема : [8/11] FidoURL.txt FGHI : area://GANJANET.LOCAL?msgid=2:5063/88+45cda41d На : area://GANJANET.LOCAL?msgid=2:5063/88+45cd9fd3 = Кодировка сообщения определена как: CP866 ================================== ============================================================================== * изначально написано в эхоконференцию FTSC_PUBLIC * также было отослано в эхоконференцию CU.TALK * также было отослано в эхоконференцию GANJANET.LOCAL * также было отослано в эхоконференцию RU.FIDO.WWW * также было отослано в эхоконференцию RU.FIDONET.TODAY * также было отослано в эхоконференцию RU.FTN.DEVELOP * также было отослано в эхоконференцию SU.FIDOTECH * также было отослано в эхоконференцию TITANIC.BEST
textsection 8 of 11 of file FidoURL.txt textbegin.section
The "msgid" optional parameter is used to designate a single message in the given message base. The value of this parameter is the contents of MSGID kludge of that message, without the leading "^MSGID: " string.
MSGID kludges are defined in FTS-0009 and serve well as unique message identifiers of echomail messages.
Note that the "msgid" optional parameter MAY designate some message that is not present in the current echomail message base of the given area. In this case, a Fidonet system MAY ask its uplink for a rescan of such an area, or use some external archive of Fidonet echomail messages, or try some other means of getting the desired message. The designated message is not available until this actions bring the desired result. And programs interpreting Fidonet URLs SHOULD NOT discard "msgid" and pretend that area://<areatag>?<optional-part> designates the whole area if the desired message can not be accessed immediately.
The "mid" optional parameter is used as a shorter equivalent to the "msgid" parameter. If the optional parameter "msgid" is not present in a given URL, the value of "mid" parameter MUST be taken instead the value of "msgid", provided that "mid" is present.
The "from" optional parameter is used to define the Fidonet netmail address of an individual or service that designated message(s) originate from.
The value of the "from" parameter uses standard Fidonet addressing notation, <zone>:<net>/<node>.<point>@<domain> (see FSP-1004 for details).
If "from" is present in the <optional-part> of an area URL, then
area://<areatag>?<optional-part>
no longer designates the whole message base of the given area, but only the message(s) posted to that area by the specified node or point. The field of that messages can be narrowed even further if some other message-identifying parameters are used in the same URL.
The "find" optional parameter implies that the designated echo area should be searched for a specific message, or several messages. The value of that "find" optional parameter contains a regular expression; the body (bodies) of found message(s) MUST match that expression.
See section 7.2.3 for the details about regular expressions.
If "find" is present in the <optional-part> of an area URL, then
area://<areatag>?<optional-part>
no longer designates the whole message base of the given area, but only the message(s) that match the specified regular expression. The field of that messages can be narrowed even further if some other message-identifying parameters are used in the same URL.
Examples:
encoded: ...&find=/\bFido(net)%3f\b/i regex: /\bFido(net)?\b/i matches: Fido matches: FIDOnet matches: FidoNet does not match: Fidonet-alike does not match: Fidobrowser does not match: fidoshnik does not match: triffidos
encoded: ...&find=/(P(2P)%7b1,4%7d%7cfile\s%2bexchange)/ regex: /(P(2P){1,4}|file\s+exchange)/ matches: P2P matches: P2P2P2P matches: P2P2P2P2P matches: file exchange matches: file exchange does not match: P2P2P2P2PP2P2P2P2P does not match: P2P2P2P2P2P does not match: fileexchange does not match: file_exchange does not match: p2p does not match: FiLe ExChanGe
Fidonet messages are able to contain kludges (see technical details in FTS-4000). Consequently, it is possible for an URL to designate a set of messages tagged by a certain kludge type or certain kludge values. The corresponding regular expression starts with ^\x1 or ^\01 symbols, which mean the begginning of line immediately followed by the SOH (Ctrl+A, ASCII 1) symbol. The expression MUST use the multi-line mode of matching ("m" flag) for the "^" construct to match at the beginning of each kludge.
Matches all messages with non-empty realname kludges.
Useful for moderators who check how the subscribers identify themselves.
encoded: ...&find=/%5E\x1Category:\s.*(music%7cweather)/im regex: /^\x1Category:\s.*(music|weather)/im matches kludge: Category: music matches kludge: Category: hardcore music matches kludge: Category: weather matches kludge: Category: real life, bad weather, bad mood
Matches all messages that belong to at least one of the given categories.
Useful to collect a single-theme subset of messages from a blog or any other information channel with a wide set of themes.
If there's a need for some URL to contain several regular expressions and to designate Fidonet messages that match at least one of those regular expressions, then the URL's author MUST unite those expressions as alternative branches of one single pattern (expression1|expression2|...) as shown in the above category-related example.
If there's a need for some URL to contain several regular expressions and to designate Fidonet messages that match every of those regular expressions, then the URL's author MUST use several "find" parameters in that URL.
Find messages that contain both kludges "Category: " and "Now playing: " with training spaces after colon.
textend.section
With best Fidonet 2.0 regards, Mithgol the Webmaster. [Real nodelisted name: Sergey Sokoloff]
... 199. I will not make alliances with those more powerful than myself. --- Come with me in the twilight of a summer night for a while... .hack//SIGN * Origin: Be careful, the paranoid ones are always wathing you!.. (2:5063/88)
