Both sides previous revisionPrevious revisionNext revision | Previous revision |
howto:editor:slyedit [2019/08/09 19:46] – [Upgrading from previous versions] Added a note for version 1.68 nightfox | howto:editor:slyedit [2022/12/16 08:43] (current) – [Configuration with Synchronet] Nightfox |
---|
====== SlyEdit ====== | ====== SlyEdit installation ====== |
SlyEdit is the second full-featured full screen editor for Synchronet, written by ''[[person:nightfox]]'' in JavaScript. SlyEdit can run in one of two styles, to mimic the look & feel of IceEdit or DCT Edit, two popular BBS message editors from the 1990s. The style is specified by a command-line argument. SlyEdit also supports customization of options via a configuration file and colors via theme files.\\ | SlyEdit is the second full-featured full screen editor for Synchronet, written by ''[[person:nightfox]]'' in JavaScript. SlyEdit can run in one of two styles, to mimic the look & feel of IceEdit or DCT Edit, two popular BBS message editors from the 1990s. The style is specified by a command-line argument. SlyEdit also supports customization of options via a configuration file and colors via theme files.\\ |
| \\ |
| The ''[[module:slyedit]]'' module page describes SlyEdit's features and configuration files in more detail. This page discusses SlyEdit's setup with Synchronet. |
\\ | \\ |
SlyEdit will recognize the user's terminal size and set up the screen accordingly.\\ | SlyEdit will recognize the user's terminal size and set up the screen accordingly.\\ |
| |
===== Getting SlyEdit ===== | ===== Getting SlyEdit ===== |
As of Synchronet 3.16, SlyEdit is included with Synchronet. The latest version of SlyEdit can also be acquired by browsing to the ''[[dev:CVS]]'' and download the SlyEdit .js files from the ''[[dir:exec]]'' directory and the SlyEdit .cfg and SlyEdit_Taglines.txt files from the ''[[dir:ctrl]]'' directory. Place the files in the respective directories in your Synchronet directory tree. | As of Synchronet 3.16, SlyEdit is included with Synchronet. The latest version of SlyEdit can also be acquired by browsing to the [[https://gitlab.synchro.net/main/sbbs/-/tree/master/exec|exec directory]] in the Synchronet ''[[dev:git]]'' repository and download the SlyEdit .js files and the SlyEdit .cfg and SlyEdit_Taglines.txt files from [[https://gitlab.synchro.net/main/sbbs/-/tree/master/ctrl|ctrl]]. Additionally, there is some SlyEdit documentation in text file format in the [[https://gitlab.synchro.net/main/sbbs/-/tree/master/docs|docs directory]]. |
| |
===== Installation ===== | ===== Installation ===== |
Copy the .js files to the ''[[dir:exec]]'' directory and the .cfg files into the ''[[dir:ctrl]]'' directory. If you make any changes to the SlyEdit configuration file (SlyEdit.cfg) or color theme files, it is recommended that you save your modified configuration/theme files to the ''[[dir:mods]]'' directory so that any modifications you make to them won't be accidentally overwritten when updating the Synchronet files from the Synchronet ''[[dev:CVS]]'' repository. | Copy the .js files to the ''[[dir:exec]]'' directory and the .cfg files into the ''[[dir:ctrl]]'' directory. If you make any changes to the SlyEdit configuration file (SlyEdit.cfg) or color theme files, it is recommended that you save your modified configuration/theme files to the ''[[dir:mods]]'' directory so that any modifications you make to them won't be accidentally overwritten when updating the Synchronet files from the Synchronet ''[[dev:git]]'' repository. |
| |
===== Configuration with Synchronet ===== | ===== Configuration with Synchronet ===== |
Make sure any or all of these configurations (as desired) are in [[util:SCFG]]->External Programs->External Editors. Note that the ARS requirements string is "ANSI AND COLS 80". This means that the user's terminal must support ANSI and have a width of at least 80 columns. Also, for best quote line behavior in various readers, the "Word Wrap Quoted Text" setting must be set to "Yes, for 80 columns" (not to wrap for the terminal width). | Make sure any or all of these configurations (as desired) are in [[util:SCFG]]->External Programs->External Editors. Note that the ARS requirements string is "ANSI AND COLS 80". This means that the user's terminal must support ANSI and have a width of at least 80 columns. |
| |
For IceEdit style:\\ | For IceEdit style:\\ |
Use Shell to Execute No | Use Shell to Execute No |
Record Terminal Width Yes | Record Terminal Width Yes |
Word Wrap Quoted Text Yes, for 80 columns | Word Wrap Quoted Text Yes, for terminal width |
Automatically Quoted Text All | Automatically Quoted Text All |
Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
Use Shell to Execute No | Use Shell to Execute No |
Record Terminal Width Yes | Record Terminal Width Yes |
Word Wrap Quoted Text Yes, for 80 columns | Word Wrap Quoted Text Yes, for terminal width |
Automatically Quoted Text All | Automatically Quoted Text All |
Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
Use Shell to Execute No | Use Shell to Execute No |
Record Terminal Width Yes | Record Terminal Width Yes |
Word Wrap Quoted Text Yes, for 80 columns | Word Wrap Quoted Text Yes, for terminal width |
Automatically Quoted Text All | Automatically Quoted Text All |
Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
The following is a list of changes and important notes for each version, if you are upgrading from a previous version of SlyEdit:\\ | The following is a list of changes and important notes for each version, if you are upgrading from a previous version of SlyEdit:\\ |
\\ | \\ |
| |
| New in version 1.80 |
| ------------------- |
| New configuration settings have been added in SlyEdit.cfg: |
| ^Setting ^ Description^ |
| | allowColorSelection | Whether or not to let the user change the text color | |
| | saveColorsAsANSI | Whether or not to save message color/attribute codes as ANSI (if not, they will be saved as Synchronet attribute codes) | |
| |
| The TextEditColor setting has been removed from the color theme configuration files. |
| |
| New in version 1.71 |
| ------------------- |
| There is a new setting in SlyEdit.cfg, allowSpellCheck, which specifies whether the spell check feature is allowed. Valid values are true and false; it defaults to true if not specified. You might want to disable spell check if, for instance, the spell check feature causes an "out of memory" error on your system. |
| |
New in version 1.68 | New in version 1.68 |
New in version 1.20 | New in version 1.20 |
------------------------- | ------------------------- |
Version 1.20 added a cross-posting feature, and there is a new configuration setting and some new color settings for cross-posting. Also, starting with version 1.20, you can put your customized SlyEdit configuration file (SlyEdit.cfg) and color theme files in the ''[[dir:mods]]'' directory so that they won't be accidentally overwritten when updating the Synchronet files from the Synchronet ''[[dev:CVS]]'' repository. | Version 1.20 added a cross-posting feature, and there is a new configuration setting and some new color settings for cross-posting. Also, starting with version 1.20, you can put your customized SlyEdit configuration file (SlyEdit.cfg) and color theme files in the ''[[dir:mods]]'' directory so that they won't be accidentally overwritten when updating the Synchronet files from the Synchronet ''[[dev:git]]'' repository. |
| |
New setting for SlyEdit.cfg: | New setting for SlyEdit.cfg: |
New in version 1.16 | New in version 1.16 |
------------------------- | ------------------------- |
As of version 1.16, the configuration files may be placed in the ''[[dir:ctrl]]'' directory if desired. This change was made for SlyEdit's inclusion in the Synchronet ''[[dev:CVS]]'' repository. The .js files can be placed anywhere, but for the standard Synchronet installation from the ''[[dev:CVS]]'' repository, the .js files will be in the ''[[dir:exec]]'' directory. | As of version 1.16, the configuration files may be placed in the ''[[dir:ctrl]]'' directory if desired. This change was made for SlyEdit's inclusion in the Synchronet ''[[dev:git]]'' repository. The .js files can be placed anywhere, but for the standard Synchronet installation from the ''[[dev:git]]'' repository, the .js files will be in the ''[[dir:exec]]'' directory. |
| |
\\ | \\ |