{"_id":"gulp-fest-hardcore","_rev":"56-153174b45e88fb51fad49851dff7bd34","name":"gulp-fest-hardcore","time":{"modified":"2022-06-18T17:04:03.392Z","created":"2014-03-20T18:28:01.888Z","0.0.1":"2014-03-20T18:28:01.888Z","0.0.2":"2014-03-24T11:54:24.205Z","0.0.3":"2014-04-18T06:48:49.619Z","0.0.4":"2014-04-18T14:15:44.426Z","0.0.5":"2014-04-18T15:12:09.817Z","0.0.6":"2014-04-18T17:37:03.225Z","0.0.7":"2014-04-21T10:52:55.111Z","0.0.8":"2014-04-29T09:47:29.972Z","0.0.9":"2014-05-26T11:48:44.605Z","0.1.0":"2014-06-20T13:44:29.710Z","0.1.2":"2014-07-01T18:59:54.145Z","0.1.3":"2014-07-02T10:46:26.179Z","0.1.4":"2014-07-18T10:33:04.450Z","0.1.5":"2014-07-21T14:58:24.292Z","0.1.6":"2014-07-22T12:35:40.062Z","0.1.7":"2014-07-23T09:20:51.582Z","0.1.8":"2014-07-25T08:38:08.885Z","0.1.9":"2014-07-25T08:47:16.859Z","0.1.10":"2014-09-15T11:49:24.201Z","0.1.11":"2014-09-23T12:02:38.743Z","0.2.0":"2014-10-16T10:38:36.410Z","0.2.1":"2014-10-21T11:08:39.273Z","0.2.2":"2015-04-13T11:52:49.143Z","1.2.1":"2015-04-15T13:00:00.992Z","0.3.2":"2016-08-01T14:24:47.791Z","0.3.3":"2016-08-02T15:25:14.115Z","0.3.4":"2016-08-03T14:18:16.935Z","1.0.0":"2017-08-16T12:12:44.579Z","2.0.0":"2017-08-16T13:19:13.752Z","3.0.0":"2017-08-17T11:33:41.294Z"},"maintainers":[{"name":"ikuznetsov","email":"killxxxvi@mail.ru"}],"dist-tags":{"latest":"3.0.0"},"description":"js, lua, Xslate templator","readme":"gulp-fest-hardcore\n==================\nFest — это шаблонизатор общего назначения, компилирующий XML шаблоны в самодостаточные JavaScript функции. Для установки требуется Node.js >= 0.8.\n![alt text](http://24.media.tumblr.com/0fc9023daa303558d036ecd63fd2c24e/tumblr_mjedslIPPH1qbyxr0o1_500.gif \"My fest\")\n### кастрированная версия\n* **нет try-cache** - надо оборачивать саму ф-ю вызова\n* нет неймспейса fest\n* нет контекста, внутри шаблона есть только params\n* выпилины конструкции:\n - `template` - контексты убраны\n - `text` - нецелесообразен\n - `element` - полигон для усложнений\n - `attributes` - нецелесообразен\n - `attribute` - нецелесообразен\n - `each` - заменён на `for`\n - `choose` - заменён на `switch`\n - `when` - заменён на `case`\n - `otherwise` - заменён на `default`\n - `script` - обычный html тег\n - `var` - заменен на `vars`\n\n* изменены параметры и значения по умолчанию\n - `value` _output_ -> _escape_ по умолчанию **text**, вместо html\n - `for` _from=\"1\" to=\"5\"_ **выпилено**\n\n* добавлены\n + `for` _in_ <- `each`\n + `switch` <- `choose`\n + `case` <- `when`\n + `default` <- `otherwise`\n + `vars` <- `var`\n + `js`, `lua`, `xslate`, `only` <- `script`\n\n* нада быть внимательным: формируемый шаблон условно делится на выражения и возвращаемое значения.\n```xml\n\n\n (params.c = params.a + params.b, params.c)\n\n\n fail\n\n\n```\n\n```xml\n\n\n\n good\n\n\n```\n\n\n\n## Установка\n\n```\nnpm install gulp-fest-hardcore\n```\n\n## Введение\n\nШаблоны представляют собой псевдо XML документы, содержащие HTML, текстовые данные и управляющие конструкции.\n\n```xml\n Hello, params.name!\n```\n\n_Замечание: начальные и конечные пробелы в текстовых узлах удаляются при компиляции. Если необходимо вывести символ пробела, можно вопспользоваться ``._\n\n## Данные и вывод\n\n### value\n\nСлужит для вывода значения JavaScript выражения. Поддерживаем 4 режима вывода: text (по умолчанию), html, js и json.\nИспользует глобальные функции: `$.escapeHTML(value)`, `$.escapeJS(value)` - их следует определить самостоятельно,\nили использовать следующие:\n\n```js\n$.escapeHTML = function (s) {\n if (typeof s === 'string') {\n if (/[&<>\"]/.test(s)) {\n return s.replace(/[&<>\"]/g, function(chr) {\n return {\n '&': '&',\n '<': '<',\n '>': '>',\n '\\\"': '"'\n }[chr]\n });\n }\n } else if (typeof s === 'undefined') {\n return '';\n }\n return s;\n}\n\n$.escapeJS = function (s) {\n if (typeof s===\"string\") {\n if (/[\\\\'\"\\/\\n\\r\\t\\b\\f<>]/g.test(s)) {\n return s.replace(/[\\\\'\"\\/\\n\\r\\t\\b\\f<>]/g, function (chr){\n return {\n '\"': '\\\"',\n '\\\\': '\\\\',\n '/' : '\\\\/',\n '\\n': '\\\\n',\n '\\r': '\\\\r',\n '\\t': '\\\\t',\n '\\b': '\\\\b',\n '\\f': '\\\\f',\n '\\'' : '\\\\\\'',\n '<' : '\\\\u003C',\n '>' : '\\\\u003E'\n }[chr];\n });\n }\n } else if (typeof s===\"undefined\") {\n return \"\";\n }\n return s;\n}\n\n$.extend = function (original, extended) {\n extended = extended || {};\n for (var key in extended) {\n original[key] = extended[key];\n }\n return original;\n}\n```\n```lua\nreturn {\n escapeHTML = function (s)\n if s == nil then return '' end\n local esc, i = s:gsub('&', '&')\n :gsub('<', '<')\n :gsub('>', '>')\n :gsub('\\\"', '"')\n return esc\n end,\n escapeJS = function (s)\n if s == nil then return '' end\n local esc, i = s:gsub('\"', '\\\"')\n :gsub('\\\\', '\\\\')\n :gsub('/' , '\\\\/')\n :gsub('\\n', '\\\\n')\n :gsub('\\r', '\\\\r')\n :gsub('\\t', '\\\\t')\n :gsub('\\b', '\\\\b')\n :gsub('\\f', '\\\\f')\n :gsub('\\'' , '\\\\\\'')\n :gsub('<' , '\\\\u003C')\n :gsub('>' , '\\\\u003E')\n return esc\n end,\n extend = function (destination, source)\n for k,v in pairs(source) do\n destination[k] = v\n end \n return destination\n end\n}\n```\n\n\n```xml\n\nvalue\nvalue\nvalue\n```\n\n### vars\nУстаналивает локальную JavaScript переменную.\n**имя будет принудительно переведено в lowercase**\n```xml\n\nIllegar\nillegar\nquestion\nanswer\n```\n\n### space\nСлужит для вывода пробела. Необходим в тех случаях, когда пробел в тектовом узле удаляется при компиляции, например:\n```xml\nHello,json.name!\n```\n\n### require\nВызывает через require модуль с параметрами по аналогии с `get`\n```xml\n{some: 'data'}\n\n\n\n \n {a: 1, b:2}\n \n \n
1
\n \n\n\n\n\n\n\n\n {a:2,b:3,c:4}\n\n\n```\n\n\n### set\nОбъявляет именованную функцию. Содержимое `set` не будет выполнено до тех пор, пока не будет вызван блок с таким же имененем с помощью `get`.\n```xml\nJohn\n```\n\n```xml\n\n F. Kennedy\n\n```\n\nВнутри `set` доступен контекст `params`, передаваемый через `get`.\n```xml\n\n Hello,params.username!\n\n{username: \"John\"}\n```\n\n### get\nВыводит содержимое блока, объявленного через `set`.\n```xml\n\n```\n\n```xml\n{'some': 'data'}\n\n {a: 1, b:2}\n\n\n\n \n {a: 1, b:2}\n \n \n
1
\n \n\n\n\n```\n\nВнутри атрибута `name` можно использовать JavaScript выражения для вычисления имени блока во время выполнения. Значения выражений, заключенных в фигурные скобки, объединяются с примыкающим текстом. Помимо этого, можно использовать атрибут `select`.\n\n```xml\n\n\nfoo\nbar\n\n```\n\nСуществует быстрый способ вывести значение в атрибут:\n\n```xml\nSome link\n```\n\n## Управляющие конструкции\n\n### for\n\nВыполняет итерацию по массиву или числовому ряду. неявно оборачивается if который проверяет iterate и его length, в связи с этим можно после закрытия `` пришпилить `elseif` или `else` как в обычном `if` стеке\n\n```xml\n\n\n params.items[i]\n\n\n\n\n v\n\n\n\n\n\n v\n\n\n\n \n v\n \n\n\n foo text\n\n\n bar text\n\n\n else text\n\n```\n\n### if, elseif, else\n\nУсловный оператор.\n\n```xml\n\n var0\n\n\n var2\n\n\n ELSE\n\n```\n\n### switch case default\n\n```xml\n\n \n var is 1\n \n \n var is '2'\n \n \n var is `a`\n \n \n var is not 1 or 2\n \n\n```\n\nЕсли нужно \n```javascript\nswitch (z) {\n case 'a':\n case 'b':\n case 'c':\n domagick;\n break;\n case 'd':\n doD;\n break;\n default:\n 'docommon'\n}\n```\nпользуй аттрибут `any` и сепаратор значений `|`. \nне нужен `break`? пользуй аттрибут `nobreak` \n```xml\n\n \n domagick\n \n \n doD\n \n \n docommon\n \n\n```\n\n## Остальные конструкции\n\n### cdata\n\nСлужит для вывода блока CDATA.\n\n```xml\n\n alert (\"2\" < 3);\n\n```\n\n### comment\n\nВыводит HTML комментарий.\n\n```xml\ncomment -->\n```\n\n### doctype\n\nЗадает DOCTYPE генерируемой страницы.\n\n```xml\nhtml\n```\n\n### include\nвыпилено\n### insert\nВставить файл напрямую в шаблон\n`src` - относителен к текущему файлу (его папке)\n```xml\n