====== text directory ======

The Synchronet ''text'' directory contains several forms of text files, generally displayable to users of the BBS.
===== Directory Contents =====
With a few exceptions, the ''text'' directory contains files that may be displayed to users (e.g. menu files displayed in the Terminal Server).

The stock/default contents of the ''text'' directory can be browsed online [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/text|here]].

A daily snapshot archive of the stock/default contents of the ''text'' directory can downloaded in [[ftp://ftp.synchro.net/sbbstext.zip|zip]] (for Windows) or [[ftp://ftp.synchro.net/sbbstext.tgz|tgz]] (for *nix).

Since many of the files in the ''text'' directory may reflect the sysop's personal customizations, it's a highly recommended to be very careful when replacing/overwriting any files in this directory.
===== Sub-directories =====

==== menu ====
The menu files displayed to users of the [[server:Terminal]] Server are stored in the ''text/menu'' directory.

References to the files in the ''text/menu'' directory may be made from [[custom:command shell|command shells]], [[module:|loadable modules]], [[service:|services]], [[custom:text.dat]] lines, and web interface scripts.
  * See the Baja ''menu'' [[http://synchro.net/docs/baja.html#DisplayFunctions|display function]]
  * See the JavaScript ''bbs.menu()'' [[http://synchro.net/docs/jsobjs.html#bbs_methods|method]]

Files in the ''text/menu'' directory (and its sub-directories) are special because there may be multiple terminal-specific versions of each menu base filename. The ''.asc'' version of a menu file is considered the "lowest common denominator", and will be displayed when other versions do not exist or the user's terminal has no special capabilities (e.g. TTY).

See [[config:text files]] for more details about the various file types supported in the ''text/menu'' directory (e.g. ''.msg'', ''.asc'', ''.ans'', ''.mon'', ''.rip'', etc.).

Sub-directories of the ''text/menu'' directory are used for the storage of menu files that have been translated to alternate languages (indicated by ''[[dir:ctrl]]/[[custom:text.ini|text.lang.ini]]'' files).

Sub-directories of the ''text/menu'' directory may be used for the storage of menu files for (non-default or 3rd party) command shells.
==== avatars ====

The ''text/avatars'' directory contains avatar collections (''*.bin'' files) from which the BBS users may select a pre-made avatar for their personal use. 

See the [[module:avatars]] module for more details.

===== See Also =====

  * [[./index|Directory structure]]
  * [[:config:text_files|Text files]]
  * [[:module:Avatars]]
  * [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/text|text directory in CVS]]


