{"id":17651057,"url":"https://github.com/tilap/gulppage","last_synced_at":"2025-03-30T08:27:24.556Z","repository":{"id":20260412,"uuid":"23533299","full_name":"tilap/gulppage","owner":"tilap","description":"Gulp stack for fast static page dev","archived":false,"fork":false,"pushed_at":"2014-09-07T13:10:33.000Z","size":341,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-05T10:34:43.609Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tilap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-09-01T06:52:02.000Z","updated_at":"2014-09-07T13:10:34.000Z","dependencies_parsed_at":"2022-09-01T10:51:36.504Z","dependency_job_id":null,"html_url":"https://github.com/tilap/gulppage","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilap%2Fgulppage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilap%2Fgulppage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilap%2Fgulppage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilap%2Fgulppage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tilap","download_url":"https://codeload.github.com/tilap/gulppage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246293859,"owners_count":20754335,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-23T11:40:10.968Z","updated_at":"2025-03-30T08:27:24.537Z","avatar_url":"https://github.com/tilap.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gulppage\n\n**Gulppage** serve static files (html, css, js) based on compiled sources. It is built over gulp and provides a quick \nand easy environment for building static pages from scratch.\n\nIt provides a large features and options to make page dev quick: less  compilation, javascript browerification, vendor \nmanagement, fontello integration and much more. An effort has been done on log too, in order to provide quick debug if \nneeded.\n\nIt also comes with an export command. So once your dev is ok, you can export the result easily in a tarball and put it \non a server.\n\nFor any bug or feature query, please report to the [github project](https://github.com/tilap/gulppage/issues)\n\n## Features\n\n- **html**:\n    - linter: [htmlhint](https://www.npmjs.org/package/gulp-htmlhint), with your own custom options (see \n    [options](https://github.com/yaniswang/HTMLHint/wiki/Rules) for more details).\n    - compilation:\n        - [usemin](https://github.com/zont/gulp-usemin) allow you concat and easily embed vendor javascript, css or \n        external html;\n        - minification with [htmlmin](https://github.com/bezoerb/gulp-htmlhint), with your own cutom options (see \n        [options](https://github.com/kangax/html-minifier) for more details);\n        - [file include](https://github.com/coderhaoxin/gulp-file-include) to get basic html includes or templating.\n- **js**:\n    - linter: [jsHint](https://github.com/spenceralger/gulp-jshint) based on the .jshintrc project file and/or custom \n    options.\n    - compilation:\n        - [browserify](https://github.com/deepak1556/gulp-browserify), the magic javascript include way;\n        - [uglify](https://github.com/terinjokes/gulp-uglify) to make it lighter;\n- **less**:\n    - linter: [recess](https://github.com/sindresorhus/gulp-recess)\n    - compilation:\n        - [less compilation](https://github.com/plus3network/gulp-less);\n- **assets**:\n    - [optimization of your images](https://github.com/sindresorhus/gulp-imagemin)\n- **icons**\n    - command line to open and select your [fontello](https://github.com/fontello/fontello) icon set, and once done, to \n    import and save it locally.\n- **livereload**:\n    All the task for Javascript, Css, Html or assets comes with livereload option, so you can dev fast\n- **project reseting**:\n    - a gulp task allow you to clean up all the generated files fast;\n- **gulpfile**:\n    - autorestart server when changed\n\n## Install\n\nTo install in a \"mylanding\" folder, use shell command and run:\n\n```\ngit clone https://github.com/tilap/gulppage.git mylanding\ncd mylanding\nmake install\n```\n\n## Running\n\nAll the common run task comes with ```make``` and package the gulp task in order.\n\n_note_: Take care to avoid folder with the same name as main args, ie \"install\", \"update\", \"reset\", \"watch\", \"export\", \n\"fontgettoken\", \"fontopenmac\", \"fontopenlinux\", \"fontsave\"\n\n### Make update\n\nUpdate the packages dependancies, both bower and npm. Clean the old ones and install the new ones (prune).\n\n### Make reset\n\nDelete the compiled files and the installed bower/npm packages. You can then rerun ```make install``` to restart a new\nproject.\n\n### Make watch\n\nBuild the initial sources and start watching all the source for livereloading.\n\n### Make export\n\nRebuild clean output and make a tarball.\n\n### Fonticon management\n\n```make fonopenmac```  and ```make fonopenlinux``` open the fonticon set in your browser. You can thus edit all you need\nand save the session directly on your browser. THen run ```make fontsave```in your term, and the new font package will \nbe importer. If you host your own fontelle server, edit the makefile option.\n\n## Sample / Demo\n\nIf you wanna see a basic usage sample, run the project by with src-sample (remove src folder and rename src-sample to src, or edit the config.js file). You'll have a really basic example with less working (bootstrap integration), browserify, a stupid image asset and an icon. You can sse the result on [this page](http://tilap.github.io/gulppage/).\n\n## Tip's\n\n- By using usemin plugin over your css/js compiled files, you automatically have file revision, so no fucking browser \ncache problem;\n- With fontello, you can use your own fonticon / svg by importing them and keep track easily;\n- take care of keeping fonticon css file (or any file using css import) out of usemin to avoid import breakings;\n- If you work on email templating, modify the gulpfile to use [gulp inline css](https://github.com/jonkemp/gulp-inline-css) plugin. I'll maybe do a branch or another repo for that\nkind of work.\n\n## LICENCE\n\nProject released under [MIT licence](https://raw.githubusercontent.com/tilap/gulppage/master/LICENCE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilap%2Fgulppage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftilap%2Fgulppage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilap%2Fgulppage/lists"}