StarMirror/showdown
1
0
Fork 0
mirror of https://github.com/showdownjs/showdown.git synced 2024-03-22 13:30:55 +08:00
Code Issues Projects Releases Wiki Activity

doc(showdown.js): add source documentation for showdown's api

Browse Source
This commit is contained in:
Estevão Soares dos Santos 2015-01-19 16:28:14 +00:00
parent c528f4a427
commit 8ee87ead9f
1 changed files with 28 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
src/showdown.js
View File

@ -7,7 +7,7 @@ var showdown = {},
parsers = {},
globalOptions = {
omitExtraWLInCodeBlocks: false,
prefixHeaderId: false
prefixHeaderId: false
};
///////////////////////////////////////////////////////////////////////////
@ -27,24 +27,42 @@ showdown.helper = {};
showdown.extensions = {};
//Public methods
/**
* Set a global option
*
* @param {string} key
* @param {string} value
* @returns {showdown}
*/
showdown.setOption = function (key, value) {
'use strict';
globalOptions[key] = value;
return this;
};
/**
* Get a global option
*
* @param {string} key
* @returns {*}
*/
showdown.getOption = function (key) {
'use strict';
return globalOptions[key];
};
/**
* Get the global options
* @returns {{omitExtraWLInCodeBlocks: boolean, prefixHeaderId: boolean}}
*/
showdown.getOptions = function () {
'use strict';
return globalOptions;
};
/**
* Static Method
* Get or set a subParser
*
* subParser(name) - Get a registered subParser
* subParser(name, func) - Register a subParser
@ -68,6 +86,7 @@ showdown.subParser = function (name, func) {
};
/**
* Showdown Converter class
*
* @param {object} [converterOptions]
* @returns {{makeHtml: Function}}
@ -98,7 +117,12 @@ showdown.Converter = function (converterOptions) {
}
}
var makeHtml = function (text) {
/**
* Converts a markdown string into HTML
* @param {string} text
* @returns {*}
*/
function makeHtml(text) {
//check if text is not falsy
if (!text) {
@ -149,7 +173,7 @@ showdown.Converter = function (converterOptions) {
//});
return text;
};
}
return {
makeHtml: makeHtml