| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
| howto:editor:slyedit [2018/03/01 12:21] – old revision restored digital man | howto:editor:slyedit [2022/07/06 16:11] – [SlyEdit] Updated the title to be more clear it's the page for installing SlyEdit (as thre were 2 pages titled SlyEdit), and added a link to the SlyEdit module page in the top section nightfox |
|---|
| ====== SlyEdit ====== | ====== SlyEdit installation ====== |
| [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|SlyEdit Message Editor]] Version 1.54 (released on 2017-12-26) is the second full-featured full screen editor for Synchronet, written entirely 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.\\ |
| \\ | \\ |
| SlyEdit will recognize the user's terminal size and set up the screen accordingly. The width of the edit area will always be 80 characters and support up to 79 characters of text; however, an increased terminal size will provide more room for information to be displayed such as the message area, from/to names, etc. Also, a terminal height greater than the standard 24 or 25 characters will provide a taller edit area, allowing more of the message to be seen on the screen at a time.\\ | 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.\\ |
| \\ | \\ |
| Thanks go out to all the sysops and users who have reported bugs, made suggestions, and helped test SlyEdit, including the following people: | Thanks go out to all the sysops and users who have reported bugs, made suggestions, and helped test SlyEdit, including the following people: |
| |
| ===== Getting SlyEdit ===== | ===== Getting SlyEdit ===== |
| SlyEdit can be acquired in one of the following ways:\\ | 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]]. |
| * Browse to the ''[[dev:CVS]]'' and download the SlyEdit .js files from the ''[[dir:exec]]'' directory and the SlyEdit .cfg files from the ''[[dir:ctrl]]'' directory. | |
| * Download SlyEdit from the [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|Digital Distortion BBS Doors and Tools page]] | |
| |
| ===== 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. | 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:\\ |
| Internal Code SLYICE | Internal Code SLYICE |
| Command Line ?slyedit %f ICE | Command Line ?slyedit %f ICE |
| Access Requirements ANSI | Access Requirements ANSI AND COLS 80 |
| Intercept I/O No | Intercept I/O No |
| Native Executable No | Native Executable No |
| Use Shell to Execute No | Use Shell to Execute No |
| Word Wrap Quoted Text Yes | Record Terminal Width Yes |
| | Word Wrap Quoted Text Yes, for 80 columns |
| Automatically Quoted Text All | Automatically Quoted Text All |
| Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
| Internal Code SLYDCT | Internal Code SLYDCT |
| Command Line ?slyedit %f DCT | Command Line ?slyedit %f DCT |
| Access Requirements ANSI | Access Requirements ANSI AND COLS 80 |
| Intercept I/O No | Intercept I/O No |
| Native Executable No | Native Executable No |
| Use Shell to Execute No | Use Shell to Execute No |
| Word Wrap Quoted Text Yes | Record Terminal Width Yes |
| | Word Wrap Quoted Text Yes, for 80 columns |
| Automatically Quoted Text All | Automatically Quoted Text All |
| Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
| Internal Code SLYRAND | Internal Code SLYRAND |
| Command Line ?slyedit %f RANDOM | Command Line ?slyedit %f RANDOM |
| Access Requirements ANSI | Access Requirements ANSI AND COLS 80 |
| Intercept I/O No | Intercept I/O No |
| Native Executable No | Native Executable No |
| Use Shell to Execute No | Use Shell to Execute No |
| Word Wrap Quoted Text Yes | Record Terminal Width Yes |
| | Word Wrap Quoted Text Yes, for 80 columns |
| Automatically Quoted Text All | Automatically Quoted Text All |
| Editor Information Files QuickBBS MSGINF/MSGTMP | Editor Information Files QuickBBS MSGINF/MSGTMP |
| BBS Drop File Type None | BBS Drop File Type None |
| |
| ===== SlyEdit configuration file ===== | ===== SlyEdit configuration files ===== |
| The configuration file, SlyEdit.cfg (located in the ''[[dir:ctrl]]'' directory), is a regular text file. It is split up into 3 sections - Behavior, Ice colors, and DCT colors. These sections are designated by [BEHAVIOR], [ICE_COLORS], and [DCT_COLORS], respectively. Each setting has a name=value format. Comments can be added on their own line starting with a ; (semicolon) character. The settings for SlyEdit.cfg are described below:\\ | See ''[[module:slyedit]]'' for detailed information about SlyEdit's configuration file & color theme files. |
| \\ | |
| Behavior settings | |
| ----------------- | |
| ^ Setting ^ Description^ | |
| | displayEndInfoScreen | Whether or not to display the info screen when SlyEdit exits. Valid values are true and false. If this option is not specified, this feature will be enabled by default. | | |
| | userInputTimeout | Whether or not to use an input timeout for users. Valid values are true and false. Note: The input timeout is not used for sysops. If this option is not specified, this feature will be enabled by default. This option was added in version 1.08. | | |
| | inputTimeoutMS | The amount of time (in milliseconds) to use for the input timeout. If this option is not specified, this option will default to 300000. This option was added in version 1.08. | | |
| | reWrapQuoteLines | Whether or not to re-wrap quote lines. Valid values are true and false. This feature is enabled by default. With this feature enabled, SlyEdit will re-wrap quote lines to still be complete and readable after the quote prefix character is added to the front of the quote lines. SlyEdit is able to recognize quote lines beginning with > or 2 letters and a > (such as EO>). If this feature is disabled, quote lines will simply be trimmed to make room for the quote prefix character to be added to the front. This option was added in version 1.15, replacing the older option splitLongQuoteLines. | | |
| | allowCrossPosting | Whether or not to allow cross-posting. Valid values are true and false. This setting is enabled by default. This option was added in version 1.20. | | |
| | enableTextReplacements | Whether or not to enable text replacements (AKA macros). Valid values are false (disabled), true (enabled with basic/literal text matching), and regex (enabled using regular expressions). | | |
| | enableTaglines | This serves as a default for user settings for whether or not to enable the option to add a tagline to their message upon saving the message. This option was added in version 1.32. | | |
| | tagLineFilename | This specifies the name of a text file where tag lines are stored. By default, it is SlyEdit_Taglines.txt. See the "Tagline configuration file" section for more details. This option was added in version 1.32. | | |
| | taglinePrefix | Some text to be added to the front of a tagline that is selected from the user. The intention of this setting is to differentiate taglines from the rest of the message. This defaults to the string "... " (3 dots and a space). If desired, this can be set to a blank string (nothing after the = ) - for instance, if you only want to put double quotes around text lines, you could set this to blank and enable the quoteTagLines setting. This option was added in version 1.33. | | |
| | quoteTaglines | Whether or not to put selected taglines in double quotes. This defaults to false. If you like taglines to have double quotes and no prefix, you can set this to true and set taglinePrefix to a blank string (nothing after the = ). This option was added in version 1.33. | | |
| | shuffleTaglines | Whether or not to shuffle (randomize) the list of taglines displayed to the user for selection. This option was added in version 1.33. | | |
| | allowUserSettings | Whether or not to allow users to configure their user settings. Valid values are true and false. Defaults to true. This option was added in version 1.32. | | |
| | useQuoteLineInitials | Whether or not to prefix quoted message lines with the previous author's initials when replying to a message. Valid values are true and false. Defaults to true. This setting serves as the default for user settings, which each user can change for themselves. If this setting is disabled, SlyEdit will simply prefix the quoted lines with " > ", as was done in IceEdit, DCT Edit, and other message editors of the early-mid 1990s. This setting is enabled by default. | | |
| | indentQuoteLinesWithInitials | When prefixing quoted messages lines with the previous author's initials, this setting specifies whether or not to indent quoted lines with a space. Valid values are true and false. Defaults to true. This setting serves as the default for user settings, which each user can change for themselves. If not specified in SlyEdit.cfg, this setting is disabled by default. | | |
| | allowEditQuoteLines | Whether or not to allow the user to edit quote lines. Valid values are true and false. Defaults to true. This was added in version 1.52. | | |
| |
| \\ | \\ |
| Ice color settings | ===== Upgrading from previous versions ===== |
| ------------------ | The following is a list of changes and important notes for each version, if you are upgrading from a previous version of SlyEdit:\\ |
| ^ Setting ^ Description^ | |
| | ThemeFilename | The name of the color theme file to use for Ice-style colors. If no theme file is specified, then default colors will be used. | | |
| | menuOptClassicColors | Whether or not to use the classic Ice-style menu option colors. Valid options are true and false. If this option is set to false, then new colors will be used for Ice-style menu options. If this is set to true, then the classic Ice-style menu option colors will be used. Note that if this is set to false, the color setting SelectedOptionTextColor won't be used. This setting was added in version 1.34. | | |
| \\ | \\ |
| DCT color settings | |
| ------------------ | |
| ^ Setting ^ Description^ | |
| | ThemeFilename | The name of the color theme file to use for DCT-style colors. If no theme file is specified, then default colors will be used. | | |
| |
| \\ | New in version 1.80 |
| ===== Color theme configuration files ===== | ------------------- |
| The color theme configuration files (located in the ''[[dir:ctrl]]'' directory) are regular text files. Each setting has a name=value format. Comments can be added on their own line starting with a ; (semicolon) character. The color settings use Synchronet's ''[[custom:ctrl-a_codes]]''.\\ | New configuration settings have been added in SlyEdit.cfg: |
| \\ | ^Setting ^ Description^ |
| The following are the default Ice-style theme files included with SlyEdit: | | allowColorSelection | Whether or not to let the user change the text color | |
| SlyIceColors_BlueIce.cfg (based on the original IceEdit theme) | | saveColorsAsANSI | Whether or not to save message color/attribute codes as ANSI (if not, they will be saved as Synchronet attribute codes) | |
| SlyIceColors_EmeraldCity.cfg (based on the original IceEdit theme) | |
| SlyIceColors_FieryInferno.cfg (based on the original IceEdit theme) | |
| SlyIceColors_Fire-N-Ice.cfg (based on the original IceEdit theme) | |
| SlyIceColors_GenericBlue.cfg (based on the original IceEdit theme) | |
| SlyIceColors_ShadesOfGrey.cfg (based on the original IceEdit theme) | |
| SlyIceColors_PurpleHaze.cfg (an original SlyEdit theme) | |
| |
| The following are the default DCT-style theme files included with SlyEdit: | The TextEditColor setting has been removed from the color theme configuration files. |
| SlyDCTColors_Default.cfg (based on the original DCT Edit theme) | |
| SlyDCTColors_Midnight.cfg (based on the original DCT Edit theme) | |
| \\ | |
| The color settings are listed below:\\ | |
| Ice-style Color Theme Settings | |
| ------------------------------ | |
| ^ Setting ^ Description^ | |
| | QuoteLineColor | The color for quoted lines in the message | | |
| | BorderColor1 | The first color to use for borders (for alternating border colors) | | |
| | BorderColor2 | The other color to use for borders (for alternating border colors) | | |
| | KeyInfoLabelColor | The color to use for key information labels (displayed on the bottom border) | | |
| | TopInfoBkgColor | The color to use for the background in the informational area at the top | | |
| | TopLabelColor | The color to use for informational labels in the informational area at the top | | |
| | TopLabelColonColor | The color to use for the colons (:) in the informational area at the top | | |
| | TopToColor | The color to use for the "To" name in the informational area at the top | | |
| | TopFromColor | The color to use for the "From" name in the informational area at the top | | |
| | TopSubjectColor | The color to use for the subject in the informational area at the top | | |
| | TopTimeColor | The color to use for the time left in the informational area at the top | | |
| | TopTimeLeftColor | The color to use for the time left in the informational area at the top | | |
| | EditMode | The color to use for the edit mode text | | |
| | QuoteWinText | The color for non-highlighted text in the quote window | | |
| | QuoteLineHighlightColor | The color for highlighted text in the quote window | | |
| | QuoteWinBorderTextColor | The color for the quote window borders | | |
| | SelectedOptionBorderColor | The color to use for the borders around text for selected multi-choice options | | |
| | SelectedOptionTextColor | The color to use for the text for selected multi-choice options | | |
| | UnselectedOptionBorderColor | The color to use for the borders around text for unselected multi-choice options | | |
| | UnselectedOptionTextColor | The color to use for the text for unselected multi-choice options | | |
| |
| \\ | New in version 1.71 |
| DCT-style Color Theme Settings | ------------------- |
| ------------------------------ | 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. |
| ^ Setting ^ Description^ | |
| | QuoteLineColor | The color for quoted lines in the message | | |
| | TopBorderColor1 | The first color to use for the top borders (for alternating border colors) | | |
| | TopBorderColor2 | The other color to use for the top borders (for alternating border colors) | | |
| | EditAreaBorderColor1 | The first color to use for the edit area borders (for alternating border colors) | | |
| | EditAreaBorderColor2 | The other color to use for the edit area borders (for alternating border colors) | | |
| | EditModeBrackets | The color to use for the square brackets around the edit mode text that appears in the bottom border (the [ and ] around the "INS"/"OVR") | | |
| | EditMode | The color to use for the edit mode text | | |
| | TopLabelColor | The color to use for the informational labels in the informational area at the top | | |
| | TopLabelColonColor | The color to use for the colons (:) in the informational area at the top | | |
| | TopFromColor | The color to use for the "From" name in the informational area at the top | | |
| | TopFromFillColor | The color to use for the filler dots in the "From" name in the informational area at the top | | |
| | TopToColor | The color to use for the "To" name in the informational area at the top | | |
| | TopToFillColor | The color to use for the filler dots in the "To" name in the informational area at the top | | |
| | TopSubjColor | The color to use for the subject in the informational area at the top | | |
| | TopSubjFillColor | The color to use for the filler dots in the subject in the informational area at the top | | |
| | TopAreaColor | The color to use for the "Area" text in the informational area at the top | | |
| | TopAreaFillColor | The color to use for the filler dots in the "Area" field in the informational area at the top | | |
| | TopTimeColor | The color to use for the "Time" text in the informational area at the top | | |
| | TopTimeFillColor | The color to use for the filler dots in the "Time" field in the informational area at the top | | |
| | TopTimeLeftColor | The color to use for the "Time left" text in the informational area at the top | | |
| | TopTimeLeftFillColor | The color to use for the filler dots in the "Time left" field in the informational area at the top | | |
| | TopInfoBracketColor | The color to use for the square brackets in the informational area at the top | | |
| | QuoteWinText | The color for non-highlighted text in the quote window | | |
| | QuoteLineHighlightColor | The color for highlighted text in the quote window | | |
| | QuoteWinBorderTextColor | The color to use for the text in the quote window borders | | |
| | QuoteWinBorderColor | The color to use for the quote window borders | | |
| | BottomHelpBrackets | The color to use for the brackets displayed in the line of help text at the bottom | | |
| | BottomHelpKeys | The color to use for the key names written in the line of help text at the bottom | | |
| | BottomHelpFill | The color to use for the filler dots in the line of help text at the bottom | | |
| | BottomHelpKeyDesc | The color to use for the key descriptions in the line of help text at the bottom | | |
| | TextBoxBorder | The color to use for text box borders (i.e., the abort confirmation prompt) | | |
| | TextBoxBorderText | The color to use for text in the borders of text boxes (i.e., the abort confirmation prompt) | | |
| | TextBoxInnerText | The color to use for text inside text boxes | | |
| | YesNoBoxBrackets | The color to use for the square brackets used for yes/no confirmation prompt boxes | | |
| | YesNoBoxYesNoText | The color to use for the actual "Yes"/"No" text in yes/no confirmation prompt boxes | | |
| | SelectedMenuLabelBorders | The color to use for the border characters for the labels of currently active drop-down menus | | |
| | SelectedMenuLabelText | The color to use for the text for the labels of currently active drop-down menus | | |
| | UnselectedMenuLabelText | The color to use for the text for the labels of inactive drop-down menus | | |
| | MenuBorders | The color to use for the drop-down menu borders | | |
| | MenuSelectedItems | The color to use for selected items on the drop-down menus | | |
| | MenuUnselectedItems | The color to use for unselected items on the drop-down menus | | |
| | MenuHotkeys | The color to use for the hotkey characters in the menu items on the drop-down menus | | |
| |
| \\ | New in version 1.68 |
| Common colors (appearing in both Ice and DCT color theme files) | ------------------- |
| --------------------------------------------------------------- | Each paragraph of text written in a message is now saved as one long line so that they can be wrapped appropriately according to the terminal/reader width (which should work online as well as in offline readers). Also, message uploads are now supported by typing /UPLOAD (or /UL) on a line by itself (the uploaded message will replace any message written into the editor). Also, now honors the SUB_ANON and SUB_AONLY flags for the sub-boards when cross-posting so that the "from" name is "Anonymous" if either of those flags enabled. |
| ^ Setting ^ Description^ | |
| | listBoxBorder | The color to use for the borders of list boxes (such as the cross-post area selection box and text replacement list box). Prior to version 1.29, this option was called crossPostBorder. | | |
| | listBoxBorderText | The color to use for the text in the borders of list boxes (such as the cross-post area selection box and text replacement list box). Prior to version 1.29, this option was called crossPostBorderText. | | |
| | crossPostMsgAreaNum | The color to use for the message group/sub-board numbers in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostMsgAreaNumHighlight | The color to use for the highlighted (lightbar) message group/sub-board numbers in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostMsgAreaDesc | The color to use for the message group/sub-board descriptions in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostMsgAreaDescHighlight | The color to use for the highlighted (lightbar) message group/sub-board descriptions in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostChk | The color to use for the checkmarks for the enabled message sub-boards in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostChkHighlight | The color to use for the highlighted (lightbar) checkmarks for the enabled message sub-boards in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostMsgGrpMark | The color to use for the current message group marker character in the cross-post area selection box. This option was added in version 1.20. | | |
| | crossPostMsgGrpMarkHighlight | The color to use for the highlighted (lightbar) current message group marker character in the cross-post area selection box. This option was added in version 1.20. | | |
| | msgWillBePostedHdr | The color to use for the text "Your message will be posted into the following area(s)" text when exiting SlyEdit. This option was added in version 1.28. | | |
| | msgPostedGrpHdr | The color to use for the group name header when listing the message's posted message areas when exiting SlyEdit. This option was added in version 1.28. | | |
| | msgPostedSubBoardName | The color to use for the message sub-boards when listing the message's posted message areas when exiting SlyEdit. This option was added in version 1.28. | | |
| | msgPostedOriginalAreaText | The color to use for the text "(original message area)" when listing the message's posted message areas when exiting SlyEdit. This option was added in version 1.28. | | |
| | msgHasBeenSavedText | The color to use for the text "The message has been saved." when exiting SlyEdit. This option was added in version 1.28. | | |
| | msgAbortedText | The color to use for the Message Aborted text when exiting SlyEdit. This option was added in version 1.28. | | |
| | emptyMsgNotSentText | The color to use for the Message Not Sent text when exiting SlyEdit. This option was added in version 1.28. | | |
| | genMsgErrorText | The color to use for general message error text when exiting SlyEdit. This option was added in version 1.28. | | |
| | listBoxItemText | The color to use for text appearing in list boxes (such as the list of text replacements and the list of tag lines) | | |
| | listBoxItemHighlight | The color to use for the currently selected item in list boxes (such as the list of text replacements and the list of tag lines). This option was added in version 1.32. | | |
| |
| \\ | New in version 1.67 |
| ===== Upgrading from previous versions ===== | -------------------- |
| The following is a list of changes and important notes for each version, if you are upgrading from a previous version of SlyEdit:\\ | Version 1.67 added the ability to change the message subject. Note that if using a Synchronet 3.17c development build, this requires a build from July 21, 2019 or newer (that build added the ability to use the RESULT.ED file, even if the editor is configured for QuickBBS MSGINF/MSGTMP). |
| \\ | |
| | 1.66 update |
| | ----------------- |
| | For dictionaries with localized spellings, the filenames can have a "-supplemental" at the |
| | end of their name before the extension if they only contain words that are unique to a |
| | particular region that don't exist for all regions. Also, dictionary filenames can just |
| | contain the language without a localization if they contain words common to all regions. |
| | For example: |
| | ^ Filename ^ Description ^ |
| | | dictionary_en.txt | General English dictionary with spellings common to all regions | |
| | | dictionary_en-US-supplemental.txt | English word spellings only specific to the US | |
| | | dictionary_en-US.txt | Full English US dictionary | |
| | |
| | New in 1.64 |
| | ----------------- |
| | Version 1.64 added a spell checker feature. There is a new option for SlyEdit.cfg, |
| | dictionaryFilenames, which is a comma-separated list of filenames. The filenames |
| | are in the format dictionary_<language>.txt, where <language> is the language name. |
| | For dictionaryFilenames, you can also just specify the language names if you want. |
| | The dictionary filenames will be looked for in sbbs/mods, sbbs/ctrl, and then the |
| | directory where SlyEdit.js is located. |
| | |
| | New in version 1.63 |
| | ------------------------- |
| | This version allows using the full width of the terminal for message text. |
| | After upgrading to this version, if you are using a Synchronet build from |
| | April 13th, 2019 or later, ensure that the "Record Terminal Width" setting |
| | in SCFG is enabled for SlyEdit. This helps ensure that Synchronet re-wraps |
| | message text for readers if the author used a different terminal width than |
| | the reader. |
| |
| Upgrading to version 1.34 | New in version 1.34 |
| ------------------------- | ------------------------- |
| This version includes a new configuration option in SlyEdit.cfg for Ice-style colors (in the [ICE_COLORS] section): menuOptClassicColors. If this option is set to false, then new colors will be used for Ice-style menu options. If this is set to false, then the classic Ice-style menu option colors will be used. | This version includes a new configuration option in SlyEdit.cfg for Ice-style colors (in the [ICE_COLORS] section): menuOptClassicColors. If this option is set to false, then new colors will be used for Ice-style menu options. If this is set to false, then the classic Ice-style menu option colors will be used. |
| |
| Upgrading to version 1.33 | New in version 1.33 |
| ------------------------- | ------------------------- |
| In this version, taglines can now be optionally prefixed with some text and/or surrounded by double quotes. Also, the list of taglines can optionally be shuffled before being displayed to the user. Three new configuration settings have been added in this version to configure these options: | In this version, taglines can now be optionally prefixed with some text and/or surrounded by double quotes. Also, the list of taglines can optionally be shuffled before being displayed to the user. Three new configuration settings have been added in this version to configure these options: |
| | shuffleTaglines | Whether or not to shuffle (randomize) the list of taglines displayed to the user for selection. | | | shuffleTaglines | Whether or not to shuffle (randomize) the list of taglines displayed to the user for selection. | |
| |
| Upgrading to version 1.32 | New in version 1.32 |
| ------------------------- | ------------------------- |
| A new color setting has been added, listBoxItemHighlight, which is used for the currently selected item in a list box. | A new color setting has been added, listBoxItemHighlight, which is used for the currently selected item in a list box. |
| |
| \\ | \\ |
| Upgrading to version 1.29 | New in version 1.29 |
| ------------------------- | ------------------------- |
| A new "text replacements" (AKA macros) feature has been added. This feature lets you (the sysop) define words to be replaced with other text. This feature can be used, for instance, to replace commonly misspelled words with their correct versions or to replace swear words with less offensive words as the user types a message. For more details, see the section regarding text replacements in SlyEdit's readme file. | A new "text replacements" (AKA macros) feature has been added. This feature lets you (the sysop) define words to be replaced with other text. This feature can be used, for instance, to replace commonly misspelled words with their correct versions or to replace swear words with less offensive words as the user types a message. For more details, see the section regarding text replacements in SlyEdit's readme file. |
| |
| \\ | \\ |
| Upgrading to version 1.28 | New in version 1.28 |
| ------------------------- | ------------------------- |
| New general color settings (for both the DCT-style and Ice-style theme files): | New general color settings (for both the DCT-style and Ice-style theme files): |
| |
| \\ | \\ |
| Upgrading to 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: |
| |
| \\ | \\ |
| Upgrading to version 1.18 | New in version 1.18 |
| ------------------------- | ------------------------- |
| * **Important:** If you use Digital Distortion's Message Lister on your BBS, then you must update Digital Distortion's Message Lister must to at least version 1.36 in order for message quoting with author's initials to work properly when replying to a message from Digital Distortion's Message Lister. The latest version of the Digital Distortion BBS doors & add-ons can be downloaded from the [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|Digital Distortion BBS Doors and Tools page]]. | * **Important:** If you use Digital Distortion's Message Lister on your BBS, then you must update Digital Distortion's Message Lister must to at least version 1.36 in order for message quoting with author's initials to work properly when replying to a message from Digital Distortion's Message Lister. The latest version of the Digital Distortion BBS doors & add-ons can be downloaded from the [[http://digdist.synchro.net/DigDistBBSStuff/DigDistBBSStuff.html|Digital Distortion BBS Doors and Tools page]]. |
| |
| \\ | \\ |
| Upgrading to version 1.17 | New in version 1.17 |
| ------------------------- | ------------------------- |
| Starting with version 1.17, when replying to a message, quoted lines from the previous message will be prefixed with the last author's initials by default. If desired, this behavior can be disabled by adding the following line in the [BEHAVIOR] section of SlyEdit.cfg: | Starting with version 1.17, when replying to a message, quoted lines from the previous message will be prefixed with the last author's initials by default. If desired, this behavior can be disabled by adding the following line in the [BEHAVIOR] section of SlyEdit.cfg: |
| |
| \\ | \\ |
| Upgrading to 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. |
| |
| \\ | \\ |
| Upgrading to version 1.15 | New in version 1.15 |
| ------------------------- | ------------------------- |
| In version 1.15, the configuration setting splitLongQuoteLines was removed and replaced with the reWrapQuoteLines setting. Refer to the list of settings above for its description. | In version 1.15, the configuration setting splitLongQuoteLines was removed and replaced with the reWrapQuoteLines setting. Refer to the list of settings above for its description. |
| |
| \\ | \\ |
| Upgrading to version 1.08 | New in version 1.08 |
| ------------------------- | ------------------------- |
| Starting with version 1.08, the "Expand Line Feeds to CRLF" for SlyEdit in SCFG should now be set to Yes. This option enables Synchronet to save messages properly, regardless of whether Synchronet is running in Windows or a *nix system. The SCFG examples above reflect this option. Enabling this option fixes problems with line wrapping that was seen on Linux Synchronet systems when the messages were sent across some networks to other BBSs. Thanks goes to Access Denied, sysop of The Pharcyde, for helping to test this. | Starting with version 1.08, the "Expand Line Feeds to CRLF" for SlyEdit in SCFG should now be set to Yes. This option enables Synchronet to save messages properly, regardless of whether Synchronet is running in Windows or a *nix system. The SCFG examples above reflect this option. Enabling this option fixes problems with line wrapping that was seen on Linux Synchronet systems when the messages were sent across some networks to other BBSs. Thanks goes to Access Denied, sysop of The Pharcyde, for helping to test this. |
| \\ | \\ |
| |
| Upgrading to version 1.07 | New in version 1.07 |
| ------------------------- | ------------------------- |
| Starting with version 1.07, the option "Expand Line Feeds to CRLF" in SCFG should now be set to Yes. Refer to the example configuration near the top of this article. | Starting with version 1.07, the option "Expand Line Feeds to CRLF" in SCFG should now be set to Yes. Refer to the example configuration near the top of this article. |
| |
| \\ | |
| ===== Key Bindings (hotkeys) ===== | |
| These are the key bindings for SlyEdit: | |
| ==== Edit Mode ==== | |
| ^ Key ^ Description^ | |
| | Ctrl-Z | Save the message | | |
| | Ctrl-A | Abort the message | | |
| | Ctrl-D | Delete a line | | |
| | Ctrl-Q | Quote the previous message (for use when replying to a message - Opens the quote line selection window) | | |
| | Ctrl-N | Find the next occurrence of text (text search) | | |
| | Ctrl-O | Import a text file from the BBS machine (sysop only) | | |
| | Ctrl-X | Export message to a file on the BBS machine (sysop only) | | |
| | Ctrl-G | General help | | |
| | Ctrl-P | Command key help | | |
| | Ctrl-R | SlyEdit program information | | |
| | Ctrl-C | Cross-post message area selection | | |
| | Ctrl-T | List the text replacements configured for SlyEdit | | |
| | Ctrl-U | Configure user settings | | |
| | ESC | Toggle command menu | | |
| | INS (Insert) or Ctrl-I | Toggle insert/overwrite mode | | |
| | Home | Move cursor to the beginning of the line | | |
| | End | Move cursor to the end of the line | | |
| | PageUp | Page up | | |
| | PageDown | Page down | | |
| |
| ==== Quote Mode ==== | |
| ^ Key ^ Description^ | |
| | Up arrow | Scroll up one line | | |
| | Down arrow | Scroll down one line | | |
| | Enter | Select & insert quote line into message | | |
| | HOME | Go to the first quote line on the current page | | |
| | END | Go to the last quote line on the current page | | |
| | PageUp | Page up | | |
| | PageDown | Page down | | |
| | F | Go to the first page of quote lines | | |
| | L | Go to the last page of quote lines | | |
| | Ctrl-Q or ESC | Close the quote line window (quit out of quote mode) | | |
| |
| ==== Cross-post message area selection ==== | |
| ^ Key ^ Description^ | |
| | Up arrow | Scroll up | | |
| | Down arrow | Scroll down | | |
| | HOME | Go to the first line on the current page | | |
| | END | Go to the last line on the current page | | |
| | PageUp | Previous page of message groups/sub-boards | | |
| | PageDown | Next page of message groups/sub-boards | | |
| | F | First page of message groups/sub-boards | | |
| | L | Last page of message groups/sub-boards | | |
| | Enter | List sub-boards in selected message group, or toggle message sub-board for cross-posting | | |
| | Number input | Specify the message group/sub-board number | | |
| | Ctrl-C or ESC | Quit out of sub-board selection (and close the box when in the message group list) | | |
| | ? | Show cross-posting help | | |
| |
| **Note:** It takes a couple of seconds to recognize the ESC key, so when using the ESC key, there will be a noticeable delay before the action takes place. | |
| |
| ===== Tagline configuration file ===== | |
| The tagline configuration file (by default, SlyEdit_Taglines.txt) can be placed in one of the following directories (searched in this order):\\ | |
| - The ''[[dir:mods]]'' directory\\ | |
| - The ''[[dir:ctrl]]'' directory\\ | |
| - The same directory as SlyEdit's .js files\\ | |
| |
| The tagline configuration file is a plain text file containing a list of taglines, one on each line. SlyEdit includes its own tagline file, but you are free to edit it or use another tagline file altogether. It is recommended that taglines are limited to 78 characters in order to fit in the tagline window in SlyEdit. Taglines of any length will be used; however, only the first 78 characters will appear in the tagline selection box in SlyEdit. | |
| |
| User also have the option to use a random tagline. Taglines more than 78 characters in length are thus still useful for that purpose. | |
| |
| \\ | |
| ===== Slash Commands ===== | |
| Synchronet also supports the following slash commands, to be used on a blank line by themselves (they are not case-sensitive): | |
| ^ Command ^ Description^ | |
| | /S | Save the message | | |
| | /A | Abort the message | | |
| | /Q | Quote the previous message (when replying) | | |
| | /C | Cross-post message area selection | | |
| | /T | List the text replacements configured for SlyEdit | | |
| | /U | Configure user settings | | |
| |
| \\ | |
| ===== Digital Distortion Message Lister support ===== | |
| If you use Digital Distortion Message Lister, you must update the message lister to version 1.36 or newer in order for it to work properly with SlyEdit 1.27. The reason is due to information that the message lister provides to SlyEdit. When replying to a message, SlyEdit is able to retrieve author initials when it quotes messages. Normally, SlyEdit gets the information it needs about messages directly from Synchronet, but when using the message lister, that information must be provided by the message lister, as the message lister can't change the information that Synchronet provides. Starting with version 1.36 of Digital Distortion Message Lister, the message lister always writes the message number to its drop file (rather than either the message offset or message number). | |
| |
| Version table: | |
| ^ SlyEdit ^ Digital Distortion message Lister^ | |
| | 1.27+ | 1.36+ | | |
| | 1.26 | 1.35 | | |
| | 1.25 | 1.34 | | |
| | 1.18 | 1.31 | | |
| |
| \\ | |
| ===== See Also ===== | ===== See Also ===== |
| * [[:howto:editor:|howto:editor index]] | * [[:howto:editor:|howto:editor index]] |
| |
| {{tag>javascript editor}} | {{tag>javascript editor}} |
