All the docs related files (docs-app, doc-gen, content, etc)
are now to be found inside the `/aio` folder.
The related gulp tasks have been moved from the top level
gulp file to a new one inside the `/aio` folder.
The structure of the `/aio` folder now looks like:
```
/aio/
build/ # gulp tasks
content/ #MARKDOWN FILES for devguides, cheatsheet, etc
devguides/
cheatsheets/
transforms/ #dgeni packages, templates, etc
src/
app/
assets/
content/ #HTML + JSON build artifacts produced by dgeni from /aio/content.
#This dir is .gitignored-ed
e2e/ #protractor tests for the doc viewer app
node_modules/ #dependencies for both the doc viewer builds and the dgeni stuff
#This dir is .gitignored-ed
gulpfile.js #Tasks for generating docs and building & deploying the doc viewer
```
Closes #14361
62 lines
1.9 KiB
JavaScript
62 lines
1.9 KiB
JavaScript
module.exports = function(encodeCodeBlock) {
|
|
// var MIXIN_PATTERN = /\S*\+\S*\(.*/;
|
|
return {
|
|
name: 'indentForMarkdown',
|
|
process: function(str, width) {
|
|
if (str == null || str.length === 0) {
|
|
return '';
|
|
}
|
|
width = width || 4;
|
|
|
|
var lines = str.split('\n');
|
|
var newLines = [];
|
|
var sp = spaces(width);
|
|
var spMixin = spaces(width - 2);
|
|
var isAfterMarkdownTag = true;
|
|
lines.forEach(function(line) {
|
|
// indent lines that match mixin pattern by 2 less than specified width
|
|
if (line.indexOf('{@example') >= 0) {
|
|
if (isAfterMarkdownTag) {
|
|
// happens if example follows example
|
|
if (newLines.length > 0) {
|
|
newLines.pop();
|
|
} else {
|
|
// wierd case - first expression in str is an @example
|
|
// in this case the :marked appear above the str passed in,
|
|
// so we need to put 'something' into the markdown tag.
|
|
newLines.push(sp + '.'); // '.' is a dummy char
|
|
}
|
|
}
|
|
newLines.push(spMixin + line);
|
|
// after a mixin line we need to reenter markdown.
|
|
newLines.push(spMixin + ':marked');
|
|
isAfterMarkdownTag = true;
|
|
} else {
|
|
if ((!isAfterMarkdownTag) || (line.trim().length > 0)) {
|
|
newLines.push(sp + line);
|
|
isAfterMarkdownTag = false;
|
|
}
|
|
}
|
|
});
|
|
if (isAfterMarkdownTag) {
|
|
if (newLines.length > 0) {
|
|
// if last line is a markdown tag remove it.
|
|
newLines.pop();
|
|
}
|
|
}
|
|
// force character to be a newLine.
|
|
if (newLines.length > 0) newLines.push('');
|
|
var res = newLines.join('\n');
|
|
return res;
|
|
}
|
|
};
|
|
|
|
function spaces(n) {
|
|
var str = '';
|
|
for (var i = 0; i < n; i++) {
|
|
str += ' ';
|
|
}
|
|
return str;
|
|
};
|
|
|
|
}; |