Hyphenation and Syllable Counting for Text Analysis
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
R
debian
inst
man
tests
vignettes
.Rbuildignore
.Rinstignore
ChangeLog
DESCRIPTION
LICENSE
NAMESPACE
README.md

README.md

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.

More information on sylly is available on the project homepage.

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=c(getOption("repos"), reaktanz="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.

License

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.