# sylly v0.1-4

0

0th

Percentile

## Hyphenation and Syllable Counting for Text Analysis

Provides the hyphenation algorithm used for 'TeX'/'LaTeX' and similar software, as proposed by Liang (1983, <https://tug.org/docs/liang/>). Mainly contains the function hyphen() to be used for hyphenation/syllable counting of text objects. It was originally developed for and part of the 'koRpus' package, but later released as a separate package so it's lighter to have this particular functionality available for other packages. Support for various languages needs be added on-the-fly or by plugin packages (<https://undocumeantit.github.io/repos>); this package does not include any language specific data. Due to some restrictions on CRAN, the full package sources are only available from the project homepage. To ask for help, report bugs, request features, or discuss the development of the package, please subscribe to the koRpus-dev mailing list (<http://korpusml.reaktanz.de>).

# sylly

Provides the hyphenation algorithm used for 'TeX'/'LaTeX' and similar software, as proposed by Liang (1983). Mainly contains the function 'hyphen()' to be used for hyphenation/syllable counting of text objects. It was originally developed for and part of the 'koRpus' package, but later released as a separate package so it's lighter to have this particular functionality available for other packages. Support for additional languages can be added on-the-fly or by plugin packages. Due to some restrictions on CRAN, the full package sources are only available from the project homepage. To ask for help, report bugs, request features, or discuss the development of the package, please subscribe to the koRpus-dev mailing list.

## Installation

### Stable releases via CRAN

The latest release that is considered stable for productive work can be found on the CRAN mirrors, which means you can install it from a running R session like this:

install.packages("sylly")


Stable CRAN packages might fall a bit behind the recent state of development, and are only updated after a significant amount of changes or important bug fixes.

### Development releases via the project repository

Inbetween stable CRAN releases there's usually several testing or development versions released on the project's own repository. These releases should also work without problems, but they are intended to test new features or supposed bug fixes, and get feedback before the next release goes to CRAN.

Installation is fairly easy, too:

install.packages("sylly", repo="https://reaktanz.de/R")


To automatically get updates, consider adding the repository to your R configuration. You might also want to subscribe to the package's RSS feed to get notified of new releases.

If you're running a Debian based operating system, you might be interested in the precompiled *.deb packages.

### Installation via GitHub

To install the package directly from GitHub, you can use install_github() from the devtools package:

library(devtools)
install_github("unDocUMeantIt/sylly") # stable release
install_github("unDocUMeantIt/sylly", ref="develop") # development release


## Language support

This package contains class definitions, generic methods and tools for hyphenation, but no out-of-the-box support for any particular language. If you're interested in using the 'sylly' package for actual hyphenation, it is recommended to look for a matching language package at the l10n repository. the packages are called 'sylly.XX', where 'XX' abbreviates the language you're looking for (e.g., 'sylly.en' for English or 'sylly.de' for German).

## Contributing

To ask for help, report bugs, suggest feature improvements, or discuss the global development of the package, please either subscribe to the koRpus-dev mailing list, or use the issue tracker on GitHub.

### Branches

Please note that all development happens in the develop branch. Pull requests against the master branch will be rejected, as it is reserved for the current stable release.

sylly Copyright (C) 2017 m.eik michalke, released under the GNU General Public License (GPL) version 3 or (at your option) any later version.

This software is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

You should have received a copy of the license with the source package as the file COPYING or LICENSE.

## Functions in sylly

 Name Description correct.hyph Correct kRp.hyphen objects get.sylly.env Get sylly session environment show,kRp.hyphen-method Show method for sylly objects summary,kRp.hyphen-method Summary method for sylly objects hyphen Automatic hyphenation kRp.hyph.pat,-class S4 Class kRp.hyph.pat set.hyph.support Add support for new languages set.sylly.env A function to set information on your sylly environment kRp.hyphen,-class S4 Class kRp.hyphen describe Getter/setter methods for sylly objects sylly-package The sylly Package manage.hyph.pat Handling hyphenation pattern objects read.hyph.pat Reading patgen-compatible hyphenation pattern files No Results!