Felist.Com

Ad delivered by Net-On! www.net-on.net
Archive List Directory Search FAQ Navigator To list owners Feedback
Issue input Start a Newsletter List description List design List statistics Inputting instructions
SubScript - issue formation automation language
Release 1.02 dated 31.10.2000

SubScript is a simple macrolanguage, which will help you to form contents of the letter and to automate many aspects of dealing with lists. You aren't obliged to use it at all, you may form the issues as you did it before, but we hope that use of SubScript will simplify issuing the lists.

While processing text for the issue, the system finds special commands of SubScript language in the text and execute it. As a result the place of each command will be occupied by the result of its execution. We recommend to take test example and, having entered it as an issue of your list, look at the result of your work, using buttons "Show how the letter will look".

The language command looks like this:

[ SUBSCRIBE name parameter1 parameter2 .... ]
so the command is: a forward square bracket [, which is followed (possibly after the space) by the word SUBSCRIBE, which after one or more spaces may be followed by command name, which after one or more spaces is followed by command parameters (there may be no parameters) and is finished by the first met closing square bracket ].

Commands with unknown name will be deleted Commands cannot be embedded each other.

Let's consider the description and examples of results of SubScript commands' execution. If there are two examples in the description, it means that the result of the command depends on the format - HTML or Textual - of the letter formed. All examples are given for the list news.felist

  • Issue name - issue_name
  • Issue number - issue_number
  • Issue date - issue_date

  • List ID - list_id
  • List name - list_name
  • List URL - list_url

  • List master title - list_author_title
  • List master name - list_author_name
  • List master email - list_author_email
  • Link to the list master email - list_author_mailto

  • Counter of subscribers number - list_count
  • Number of subscribers - list_count_text
  • Button-counter of subscribers number address - list_count_url

  • Form for Fast Subscription - form_quick
  • Form for search in Archive of the list - form_search

  • Inclusion of content of any web page - http://

  • Link to the list archive - list_archive
  • List archive address - list_archive_url

  • Link to the list description - list_descr
  • List description address - list_descr_url

  • Link to the list statistics - list_stat
  • List statistics address - list_stat_url



    Issue name
    [ SUBSCRIBE issue_name ]

    Description - name of the issue of the list

    Example - News of the Felist.Com project dated the 4 of May

    Note that it contains the name of the list and possible addition to it, which is set then inputting issue.


    Issue number
    [ SUBSCRIBE issue_number ]

    Description - number of the issue of the list

    Example - 12345

    Number of the issue increase for one with every TEXT-issue of the list. As the cases of duplicated issues are frequent, the number may be edited through the List Description.


    Issue date
    [ SUBSCRIBE issue_date ]

    Description - date of the issue of the list

    Example - 2000-02-31

    Note that the issuing of the list may be delayed for the period of sending the lists with higher priority and if it will happen at midnight, the date may be incorrect.

    Please, don't write us about "the strange format of date" - this is the only date representation format, which case no problem in identifying of the place of day and month.


    List ID
    [ SUBSCRIBE list_id ]

    Description - list id

    Example - news.felist


    List name
    [ SUBSCRIBE list_name ]

    Description - list name

    Example - News of the Felist.Com project


    List URL
    [ SUBSCRIBE list_url ]

    Description - url of the site of the list as it is specified in list description

    Example - http://Felist.Com/


    List master title
    [ SUBSCRIBE list_author_title ]

    Description - title of the list master as it is specified in list description

    Example - List master


    List master name
    [ SUBSCRIBE list_author_name ]

    Description - name of the list master as it is specified in list description

    Example - Jon Felist


    List master email
    [ SUBSCRIBE list_author_email ]

    Description - email of the list master as it is specified in list description

    Example - ask@felist.com


    Link to the list master email
    [ SUBSCRIBE list_author_mailto ]

    Description - title and name of the list master, the link from which leads to his email

    Example in HTML - List master Felist.Com

    Example in text - List master Jon Felist - ask@felist.com


    Counter of subscribers number
    [ SUBSCRIBE list_count]

    Description - counter of subscribers number

    Example in HTML - List 'News of the Felist.Com project'

    Example in text - 123456


    Number of subscribers
    [ SUBSCRIBE list_count_text ]

    Description - number of subscribers for the moment of forming of the letter

    Example - 123456


    Button-counter of subscribers number address
    [ SUBSCRIBE list_count_url ]

    Description - address of the button-counter of subscribers number

    Example - http://Felist.Com/stat/news.felist/count.gif


    Link to the list archive
    [ SUBSCRIBE list_archive ]

    Description - words 'List Archive' with the link to it

    Example in HTML - List Archive

    Example in text - List Archive - http://Felist.Com/archive/news.felist


    List archive address
    [ SUBSCRIBE list_archive_url ]

    Description - address of the archive of the list

    Example - http://Felist.Com/archive/news.felist


    Link to the list description
    [ SUBSCRIBE list_descr ]

    Description - words 'List Description' with the link to it

    Example in HTML - List Description

    Example in text - List Description - http://Felist.Com/catalog/news.felist


    List description address
    [ SUBSCRIBE list_descr_url ]

    Description - list description address

    Example - http://Felist.Com/catalog/news.felist


    Link to the list statistics
    [ SUBSCRIBE list_stat ]

    Description - words 'List Statistics' with the link to it

    Example in HTML - List Statistics

    Example in text - List Statistics - http://Felist.Com/stat/news.felist


    List statistics address
    [ SUBSCRIBE list_stat_url ]

    Description - list statistics address

    Example - http://Felist.Com/stat/news.felist


    Form for Fast Subscription
    [ SUBSCRIBE form_quick id1 id2 ... idN ]

    Description - form for fast subscription to the lists, whose id are specified as the parameters of the command, with choice of format. Unknown list id will be ignored. In case of absence of parameters the result is empty.

    Example - [ SUBSCRIBE form_quick news.felist hscope.edaily.aries ]

    Example in HTML:

    Lists at Felist.Com
    News of Felist.Com project
    Daily horoscope. Aries
    HTML TEXT

    Example in text:

    Subscription to the lists of Felist.Com:
    
      News of the Felist.Com project
        http://Felist.Com/catalog/news.felist
    
      Daily horoscope. Aries
        http://Felist.Com/catalog/hscope.edaily.aries
    


    Form for search in Archive of the list
    [ SUBSCRIBE form_search ]

    Description - form for search in Archive of the list.

    Example in HTML:
    Archive at Felist.Com
    Search in the list's archive
    "News of Felist.Com project"


    Example in text:

    Search in Archive of the list - http://Felist.Com/archive/news.felist
    


    Inclusion of content of any web page
    [ SUBSCRIBE web-page-address ]
    [ SUBSCRIBE web-page-address charset=w]

    Description - the command includes the content of web page specified to the letter of the list

    Example - [ SUBSCRIBE http://www.citycat.ru/~hac/ ]

    Algorithm:

    1. Reference to the page specified to get its contents. If the server does not respond for 2 minutes - this is an error. If the server returns something different from text or HTML - this is an error.
    2. If content of page is HTML, only the part of the page contained between tags <BODY> and </BODY> will be processed.
    3. The obtained text is filtered according to rules described on the page How the letter of the list is formed.
    4. The result of filtering is processed by the SubScript interpreter.
    5. The result will be automatically transformed to the Text, if the textual letter is formed, while the page in HTML is specified. And vice versa - the result will be automatically transformed in HTML, if HTML-letter is formed, while the textual page is specified.
    6. The result is included in the letter of the list as the result of execution of the command.

    Note:

    • We earnestly recommend to check the result by pressing the button "Show how the letter will look" on the page of list input.
    • In the case of any HTTP-error sending of the list will be interrupted and the message to the hidden address of the list master will be sent.
    • If the issue is inputted with delay of sending for certain time, the reference to the pages specified will take place not at the moment of input of the issue, but at the moment of its real sending.
    • If the page specified consists of frames, the result will be rather deplorable. Specify the direct address of page included in frame.
    • If the page specified contains scripts in java or javascript, those script won't be executed.
    • The relative links of the page will stay relative. But they will work concerning the letter of the list. If you include in the issue your own page, you should have no problems with the indicating of the absolute links on this page. If that page isn't yours, you will have to get the consent of its owner.



    This is a textual example.
    Having entered it as the issue of your list press the button "Show how the letter will look" in both its variants and you will get the visual demonstration of work of SubScript language.
    
    <PRE>
    
    [ test. this isn't a command ! it must remain in the letter as is ]
    
    Issue name: [ SUBSCRIBE issue_name ]
    Issue number: [ SUBSCRIBE issue_number ]
    Issue date: [ SUBSCRIBE issue_date ]
    
    List ID: [ SUBSCRIBE list_id ]
    List name: [ SUBSCRIBE list_name ]
    List URL: [ SUBSCRIBE list_url ]
    
    List master title: [ SUBSCRIBE list_author_title ]
    List master name: [ SUBSCRIBE list_author_name ]
    List master email: [ SUBSCRIBE list_author_email ]
    Link to the list master email: [ SUBSCRIBE list_author_mailto ]
    
    Counter of subscribers number: [ SUBSCRIBE list_count ]
    Number of subscribers: [ SUBSCRIBE list_count_text ]
    Button-counter of subscribers number address: [ SUBSCRIBE list_count_url ]
    
    Link to the list archive: [ SUBSCRIBE list_archive ]
    List archive address: [ SUBSCRIBE list_archive_url ]
    
    Link to the list description: [ SUBSCRIBE list_descr ]
    List description address: [ SUBSCRIBE list_descr_url ]
    
    Link to the list statistics: [ SUBSCRIBE list_stat ]
    List statistics address: [ SUBSCRIBE list_stat_url ]
    
    Form for search in Archive of the list:
    [ SUBSCRIBE form_search ]
    
    Form for Fast Subscription:
    [ SUBSCRIBE form_quick news.felist hscope.edaily.aries ]
    
    Inclusion of content of any web page:
    [ SUBSCRIBE http://Felist.Com/ ]
    
    </PRE>
    

Issue input Start a Newsletter List description List design List statistics Inputting instructions
Archive List Directory Search FAQ Navigator To list owners Feedback

Click here for details

© Internet Projects, 1998-2000
Design: Design studio ArtStyle, 1999