What is sphinx in java

javasphinx User’s Guide¶

javasphinx is a Sphinx extension that provides a Sphinx domain for documenting Java projects and a javasphinx-apidoc command line tool for automatically generating API documentation from existing Java source code and Javadoc documentation.

Installing¶

javasphinx is available in the Python Package Index (PyPi) and can be installed using tools such as pip or easy_install ,

$ easy_install -U javasphinx

Configuration¶

To enable javasphinx for your existing Sphinx configuration add 'javasphinx' to the list of extensions in your conf.py file. javasphinx can be configured to cross link to external sources of documentation using the javadoc_url_map option,

javadoc_url_map =  'com.netflix.curator' : ('http://netflix.github.com/curator/doc', 'javadoc'), 'org.springframework' : ('http://static.springsource.org/spring/docs/3.1.x/javadoc-api/', 'javadoc'), 'org.springframework.data.redis' : ('http://static.springsource.org/spring-data/data-redis/docs/current/api/', 'javadoc') > 

Each key in the map should be a Java package. Each value is a tuple of the form (base_url, doc_type) where base_url is the base URL of the documentation source, and doc_type is one of 'javadoc' or 'sphinx' . Use 'javadoc' to indicate that the URL points to documentation output by the Javadoc tool. Likewise, Use 'sphinx' to indicate that the URL points to documentation output by javasphinx.

When comparing referenced types to the list of available packages the longest match will be used. Entries for java , javax , org.xml , and org.w3c packages pointing to http://docs.oracle.com/javase/6/docs/api are included automatically and do not need to be defined explicitly.

Java domain¶

Directives¶

The Java domain uses the name java and provides the following directives,

Describe a Java type. The signature can represent either a class, interface, enum or annotation declaration.

Use the param field to document type parameters.

.. java:type:: public interface List extends Collection, Iterable An ordered collection (also known as a *sequence*) :param E: type of item stored by the list 

Use the param field to document parameters.

Use the throws field to document exceptions thrown by the method.

Use the return field to document the return type

Describe a Java constructor.

Use the param field to document parameters.

Use the throws field to document exceptions thrown by the constructor.

Provide package-level documentation and also sets the active package for the type, method, field, constructors, and references that follow.

Use the :noindex: option if the directive is only being used to specify the active package. Only one directive for a given package should exclude :noindex: .

Declare the given type as being provided by the given package. This information helps javasphinx create cross references for types in type, method, and field declarations. It also allows explicit cross references (using the java:ref role) to exclude the package qualification.

The method, construct, field, and type directives all accept the following standard options,

Specify the package the declaration is within. Can be used instead of, or to override, a java:package directive.

Specify the class/interface the documented object is contained within. This option should be provided for any constructor, method, or field directive that isn’t nested within a corresponding type directive.

Roles¶

The following roles are provided,

This role can be used to create a cross reference to any object type within the Java domain. Aliases for this role include java:meth , java:type , java:field , java:package , and java:construct .

An explicit title can be provided by using the standard title syntax.

This role can be used to explicitly link to an externally documented type. The reference must be fully qualified and supports an explicit title using the title syntax.

The java:ref role will also create external references as a fall-back if it can’t find a matching local declaration so using this role is not strictly necessary.

javasphinx-apidoc¶

The javasphinx-apidoc tool is the counterpoint to the sphinx-apidoc tool within the Java domain. It can be used to generate reST source from existing Java source code which has been marked up with Javadoc-style comments. The generated reST is then processed alongside hand-written documentation by Sphinx.

At minimum a source and destination directory must be provided. The input directory will be scanned for .java files and documentation will be generated for all non-private types and members. A separate output file will be generated for each type (including inner classes). Each file is put within a directory corresponding to its package (with periods replaced by directory separators) and with the basename of the file deriving from the type name. Inner types are placed in files with a basename using a hyphen to separate inner and outer types, e.g. OuterType-InnerType.rst .

By default javasphinx-apidoc will not override existing files. Two options can change this behavior,

All existing output files will be rewritten. If a cache directory is specified it will be rebuilt.

Updated source files will have their corresponding output files updated. Unchanged files will be left alone. Most projects will want to use this option.

For larger projects it is recommended to use a cache directory. This can speed up subsequent runs by an order of magnitude or more. Specify a directory to store cached output using the -c option,

Specify a directory to cache intermediate documentation representations. This directory will be created if it does not already exist.

Источник

Saved searches

Use saved searches to filter your results more quickly

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.

Pure Java speech recognition library

License

cmusphinx/sphinx4

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Sign In Required

Please sign in to use Codespaces.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop

If nothing happens, download GitHub Desktop and try again.

Launching Xcode

If nothing happens, download Xcode and try again.

Launching Visual Studio Code

Your codespace will open once ready.

There was a problem preparing your codespace, please try again.

Latest commit

Git stats

Files

Failed to load latest commit information.

README

Sphinx-4 Speech Recognition System ------------------------------------------------------------------- Sphinx-4 is a state-of-the-art, speaker-independent, continuous speech recognition system written entirely in the Java programming language. It was created via a joint collaboration between the Sphinx group at Carnegie Mellon University, Sun Microsystems Laboratories, Mitsubishi Electric Research Labs (MERL), and Hewlett Packard (HP), with contributions from the University of California at Santa Cruz (UCSC) and the Massachusetts Institute of Technology (MIT). The design of Sphinx-4 is based on patterns that have emerged from the design of past systems as well as new requirements based on areas that researchers currently want to explore. To exercise this framework, and to provide researchers with a "research-ready" system, Sphinx-4 also includes several implementations of both simple and state-of-the-art techniques. The framework and the implementations are all freely available via open source under a very generous BSD-style license. Because it is written entirely in the Java programming language, Sphinx-4 can run on a variety of platforms without requiring any special compilation or changes. We've tested Sphinx-4 on the following platforms with success. To get started with sphinx4 visit our wiki http://cmusphinx.sourceforge.net/wiki Please give Sphinx-4 a try and post your questions, comments, and feedback to one of the CMU Sphinx Forums: http://sourceforge.net/p/cmusphinx/discussion/sphinx4 We can also be reached at cmusphinx-devel@lists.sourceforge.net. Sincerely, The Sphinx-4 Team: (in alph. order) Evandro Gouvea, CMU (developer and speech advisor) Peter Gorniak, MIT (developer) Philip Kwok, Sun Labs (developer) Paul Lamere, Sun Labs (design/technical lead) Beth Logan, HP (speech advisor) Pedro Moreno, Google (speech advisor) Bhiksha Raj, MERL (design lead) Mosur Ravishankar, CMU (speech advisor) Bent Schmidt-Nielsen, MERL (speech advisor) Rita Singh, CMU/MIT (design/speech advisor) JM Van Thong, HP (speech advisor) Willie Walker, Sun Labs (overall lead) Manfred Warmuth, USCS (speech advisor) Joe Woelfel, MERL (developer and speech advisor) Peter Wolf, MERL (developer and speech advisor)

About

Pure Java speech recognition library

Источник