2019-07-15 10:24:38 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace Wikimedia\Message;
|
|
|
|
|
|
|
|
|
|
/**
|
2019-08-29 20:52:27 +00:00
|
|
|
* Converts MessageValue message specifiers to localized plain text in a certain language.
|
2019-07-15 10:24:38 +00:00
|
|
|
*
|
|
|
|
|
* The caller cannot modify the details of message translation, such as which
|
|
|
|
|
* of multiple sources the message is taken from. Any such flags may be injected
|
|
|
|
|
* into the factory constructor.
|
|
|
|
|
*
|
|
|
|
|
* Implementations of TextFormatter are not required to perfectly format
|
|
|
|
|
* any message in any language. Implementations should make a best effort to
|
|
|
|
|
* produce human-readable text.
|
|
|
|
|
*
|
|
|
|
|
* @package MediaWiki\MessageFormatter
|
|
|
|
|
*/
|
|
|
|
|
interface ITextFormatter {
|
|
|
|
|
/**
|
|
|
|
|
* Get the internal language code in which format() is
|
|
|
|
|
* @return string
|
|
|
|
|
*/
|
|
|
|
|
function getLangCode();
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Convert a MessageValue to text.
|
|
|
|
|
*
|
|
|
|
|
* The result is not safe for use as raw HTML.
|
|
|
|
|
*
|
|
|
|
|
* @param MessageValue $message
|
|
|
|
|
* @return string
|
|
|
|
|
*/
|
|
|
|
|
function format( MessageValue $message );
|
|
|
|
|
}
|