Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:newslink [2018/03/01 12:11] – Links to util:binkit changed to module:binkit digital manmodule:newslink [2024/11/12 22:05] (current) – A new logo (picture from an airport newstand) digital man
Line 1: Line 1:
-====== NewsLink ====== +====== NewsLink - NNTP Gateway ====== 
-{{:module:rob_s_iphone_sept-2015_185_2_.jpg?500|A newsstand sign I saw in an airport, long after I named this module}}+{{:module:newlink_logo2.jpg??500|Another newsstand sign I saw in an airport, long after I named this module}}
 ====== Background ====== ====== Background ======
  
Line 17: Line 17:
 NewsLink is written in 100% JavaScript and the source code (if you're NewsLink is written in 100% JavaScript and the source code (if you're
 interested) is contained in the file ''newslink.js'' in the interested) is contained in the file ''newslink.js'' in the
-Synchronet ''[[dir:exec]]'' directory. Current version is always available via [[dev:CVS]].+Synchronet ''[[dir:exec]]'' directory. Current version is always available via [[dev:git]].
  
  
Line 27: Line 27:
  
  
-1. Go into [[binkit]]->External Programs->Timed Events and created a timed event+1. Go into [[:util:SCFG]]->External Programs->Timed Events and created a timed event
 for NewsLink (if one doesn't already exist). Example: for NewsLink (if one doesn't already exist). Example:
  
Line 57: Line 57:
    4: Access Requirements    4: Access Requirements
  
-Note: At this point you may want to login to your New Server with a regular+Note: At this point you may want to login to your News Server with a regular
 News Client (aka newsreader), retrieve a list of available newsgroups News Client (aka newsreader), retrieve a list of available newsgroups
 and make a list of the newsgroups you would like linked into your and make a list of the newsgroups you would like linked into your
 BBS's message areas. BBS's message areas.
 +An alternate option is to use the provided ''[[dir:exec]]/getnewsgrouplist.js'' script to retrieve a list of newsgroups from your News Server and save those to a file (e.g. ''newsgroup.lst''). Example:
 +  $ jsexec getnewsgrouplist.js user password news.example.com > newsgroup.lst
 +(Note: the ''getnewsgrouplist.js'' script supports alternate ports and group name filtering options, if you need them)
 +
  
 3. Now go into SCFG->Message Areas->USENET->Sub-boards and create some 3. Now go into SCFG->Message Areas->USENET->Sub-boards and create some
Line 79: Line 83:
    12: Purge by Age               Disabled    12: Purge by Age               Disabled
    13: Duplicate Checking         Enabled (10000 message CRCs)    13: Duplicate Checking         Enabled (10000 message CRCs)
 +   
 +An alternate option here would be to import the ''newsgroup.lst'' file if you have one, using the SCFG "Import Message Areas" option and the "USENET Newsgroup List" file format.
  
-4. For each NewsLinked sub-board, set Network Options->Internet (UUCP/NNTP) to "Yes".+4. For each NewsLinked sub-board, confirm Network Options->Internet (UUCP/NNTP) is set to "Yes".
  
 5. Edit your ''[[dir:ctrl]]/[[config:newslink.cfg]]'' file: 5. Edit your ''[[dir:ctrl]]/[[config:newslink.cfg]]'' file:
Line 88: Line 94:
   * If the News Server requires an authenticated user login, change the "USER" and "PASS" lines to specify the username and password you use   to login to the above News Server. If the "USER" line is missing or commented-out (with a semicolon), then no user authentication will be attempted (sometimes called "anonymous login").   * If the News Server requires an authenticated user login, change the "USER" and "PASS" lines to specify the username and password you use   to login to the above News Server. If the "USER" line is missing or commented-out (with a semicolon), then no user authentication will be attempted (sometimes called "anonymous login").
   * For each sub-board you configured in step 3, add an "AREA" line, specifying each sub-board's "Internal Code" (from SCFG->Message Areas).   * For each sub-board you configured in step 3, add an "AREA" line, specifying each sub-board's "Internal Code" (from SCFG->Message Areas).
-Example: AREA USENET_ALLSYSOP+Example: ''AREA USENET_ALLSYSOP''\\ 
 +(An alternate option here is to use the ''AUTO_AREAS'' keyword which will automatically link all sub-boards flagged as Internet/NNTP networked in SCFG)
   * By default, NewsLink will only import articles (aka messages) posted *after* the first scan of the newsgroups (i.e. it will not import *any* articles during the first run). If you want NewsLink to import  *all* existing articles for *all* linked newsgroups (potentially many *thousands* of messages, depending on the News Server), add the line "FLAGS I" (case insensitive). WARNING: Using this feature may cause the initial NewsLink execution to take a long time to download all the existing articles (potentially many thousands) that may be stored on the News Server.   * By default, NewsLink will only import articles (aka messages) posted *after* the first scan of the newsgroups (i.e. it will not import *any* articles during the first run). If you want NewsLink to import  *all* existing articles for *all* linked newsgroups (potentially many *thousands* of messages, depending on the News Server), add the line "FLAGS I" (case insensitive). WARNING: Using this feature may cause the initial NewsLink execution to take a long time to download all the existing articles (potentially many thousands) that may be stored on the News Server.
-  * Remove or comment-out (with a semicolon) the ''DISABLED'' line.+  * Remove or comment-out (with a semicolon) on the ''DISABLED'' line (if present).
  
 6. Now you may force the NEWSLINK timed event to run. In SBBSCTRL (Win32 GUI), 6. Now you may force the NEWSLINK timed event to run. In SBBSCTRL (Win32 GUI),
Line 149: Line 156:
 Other supported NewsLink command-line options: Other supported NewsLink command-line options:
  
-  -d      enable debug output +^ Option ^ Description ^ 
-  -ri     reset import pointers (import all) +| ''-d'' | enable debug output | 
-  -ui     update import pointers (import none) +| ''-ri'' | reset import pointers (import all) | 
-  -re     reset export pointers (export all) +| ''-ui'' | update import pointers (import none) | 
-  -ue     update export pointers (export none) +| ''-re'' | reset export pointers (export all) | 
-  -ne     no e-mail addresses +| ''-ue'' | update export pointers (export none) | 
-  -nm     no mangling of e-mail addresses (disable anti-SPAM measures) +| ''-ne'' | no e-mail addresses | 
-  -um     un-mangle e-mail addresses when importing +| ''-nm'' | no mangling of e-mail addresses (disable anti-SPAM measures) | 
-  -ix [n] import a fixed number (n) of articles/messages (default is 500)+| ''-um'' | un-mangle e-mail addresses when importing | 
 +| ''-ix //[n]//'' | import a fixed number (n) of articles/messages (default is 500) |
  
  
Line 197: Line 205:
 ====== JSexec ====== ====== JSexec ======
 With Synchronet v3.11, it is also possible to run NewsLink externally from With Synchronet v3.11, it is also possible to run NewsLink externally from
-Synchronet (or as a background timed event) by using [[binkit]].+Synchronet (or as a background timed event) by using [[util:JSexec]].
  
  
 ===== See Also ===== ===== See Also =====
   * [[config:newslink.cfg]]   * [[config:newslink.cfg]]
-  * [[binkit]]+  * [[util:JSexec]]
   * [[:service:nntp|NNTP Service]]   * [[:service:nntp|NNTP Service]]
   * [[network:USENET]]   * [[network:USENET]]
   * [[:module:|Modules]]   * [[:module:|Modules]]
  
-{{tag>usenet nntp}}+{{tag>usenet nntp jsutil}}

Trace: