{"id":18300325,"url":"https://github.com/jpdevries/generator-yomonger","last_synced_at":"2025-04-09T09:26:46.490Z","repository":{"id":12027421,"uuid":"14611547","full_name":"jpdevries/generator-yomonger","owner":"jpdevries","description":"Yeoman Generator for MODX Manager Themes","archived":false,"fork":false,"pushed_at":"2014-03-22T02:14:17.000Z","size":929,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-30T20:01:33.337Z","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/jpdevries.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-22T07:32:52.000Z","updated_at":"2021-07-13T06:49:12.000Z","dependencies_parsed_at":"2022-08-27T18:42:32.290Z","dependency_job_id":null,"html_url":"https://github.com/jpdevries/generator-yomonger","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpdevries%2Fgenerator-yomonger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpdevries%2Fgenerator-yomonger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpdevries%2Fgenerator-yomonger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpdevries%2Fgenerator-yomonger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpdevries","download_url":"https://codeload.github.com/jpdevries/generator-yomonger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248010593,"owners_count":21032951,"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-11-05T15:12:01.974Z","updated_at":"2025-04-09T09:26:46.458Z","avatar_url":"https://github.com/jpdevries.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"yomonger\n========\n\n[1]:http://yeoman.io/generators.html\n[2]:https://github.com/modxcms/revolution/tree/develop/_build/templates/default#contribution-guides\n[3]:http://devries.jp/blog/2013/11/22/meet-yomonger/#watch-screencast\n\n![](http://j4p.us/image/0l1t1e453c2p/Screen%20Shot%202013-11-22%20at%2012.23.20%20AM.png)\n\nMeet yomonger (yo-modx-manager), a friendly little monster that lives in your computer. He loves three things:\n * asking you a couple questions\n * bootstrapping your [MODX Manager theme][2]\n * being a [Yeoman generator][1] \n\n\n## Getting Started\nThe first thing we need to do, is make sure yomonger is happy. He is self consious about not being installed on every computer, but once he is setup on yours he is quickly satisfied. If you need some more convicing, you can [watch a 3min screencast][3] on Yomonger in action.\n\nFrom your terminal, run:\n\n```bash\nnpm install -g yo generator-yomonger\n```\n\nNow that you've installed yo and generator-yomonger globally you can use it from within any directory. While yomonger can occupy any directory, he'd much prefer to be within a local MODX install so he knows his way around a bit. So if you have one, let's head there and make our own theme. We'll call it `custom-theme`.\n\n#### Creating a Theme Directory\n```bash\n# go to wherever your MODX install is\ncd ~/Sites/modx/revolution/\n# make a template directory\nmkdir manager/templates/custom-theme\n```\n_Note: Manually creating the theme directory is optional. Yomonger will take it upon himself if necessary, but he just wants to make sure you know where your stuff will wind up._\n\nGreat, that is where yomonger will assume he should create your project. Let's get him focused on the task at hand.\n\n#### Creating a build directory\n\n```bash\n# go to wherever your MODX install is\ncd ~/Sites/modx/revolution/\n# make a build directory\ncd _build/templates\nmkdir custom-theme \u0026\u0026 cd $_\n```\n\nWe are almost ready to let yomonger do his thing. But first, make note of your `manager/templates/custom-theme` directory relative to your build directory. It should be `../../../manager/templates/custom-theme`. By default yomonger will hop up three directories (you should see him do it to) and then scurry into the `manager/templates` directory looking for a folder with the name of your theme. If you want him to go somewhere else, you can tell him so but not until he asks.\n\n## Generating a Project\n\nFrom the terminal, run:\n\n```bash\nyo yomonger\n```\n\nYou'll be greated by a friendly fellow named yeoman and then be asked several questions. Choose your answers carefully and let's meet back here when you are through.\n\n```bash\n     _-----_\n    |       |\n    |--(o)--|   .--------------------------.\n   `---------´  |    Welcome to Yeoman,    |\n    ( _´U`_ )   |   ladies and gentlemen!  |\n    /___A___\\   '__________________________'\n     |  ~  |\n   __'.___.'__\n ´   `  |° ´ Y `\n```\n\n...\n\nWell hello there. That didn't take log. Let's see if he generated all your stuff.\n\n```bash\n├── .editorconfig\n├── .jshintrc\n├── bower.json\n├── Gruntfile.js\n├── package.json\n```\n\nHe snuck a little something in there didn't he? Well probably that's because you told him to. If you asked for Sass you'll have a `sass` directory:\n\n```bash\n├── sass\n│   ├── index.scss\n│   ├── login.scss\n```\n\nIf you asked to start with the included Sass files of the default manager theme he moved several files into place for you. Did you give him a tip?\n\n```bash\n├── sass\n│   ├── _box-sizing.scss\n│   ├── __buttons.scss\n│   ├── _colors-and-vars.scss\n│   ├── _forms.scss\n│   ├── _help.scss\n│   ├── _image-set.scss\n│   ├── _navbar.scss\n│   ├── _tabs.scss\n│   ├── _tree.scss\n│   ├── _uberbar.scss\n│   ├── _utility.scss\n│   ├── _xtheme-modx.scss\n│   ├── components\n│       ├── _components.scss\n│       ├── _primary-button.scss\n│       ├── _shaded-box.scss\n│   ├── index.scss\n│   ├── index.scss\n```\n\nIf you went with Less or raw CSS, well you know what you got.\n\n## Building a Project\nNow yomonger is a little compulsive, so he probably already did this for you. That's why you saw a bunch of npm stuff get installed. Let's have a look at what he did.\n\nFirst he installed your node dependencies for you like this:\n\n```bash\nnpm install\n```\n\nThen he just couldn't stand it, and had to see if your project would build successfully. Awesome, you got the works, all the grunt tasks you expect when [contributing to the default Manager theme](https://github.com/modxcms/revolution/tree/develop/_build/templates/default).\n\n```bash\ngrunt build\n```\n\nGrunt Commands\n----------------------------\n\n__Build__\u003cbr\u003e\nFetch dependencies (such as bourbon), move items into place and compile by running:\n\n```bash\ngrunt build\n```\n\n__Watch__\u003cbr\u003e\nWatch files for changes type the following:\n\n```bash\ngrunt\n```\n_Note: grunt is now watching files for changes. When Sass files are changed CSS will automatically be generated.\u003cbr\u003eInstall the LiveReload [browser extension](http://feedback.livereload.com/knowledgebase/articles/86242-how-do-i-install-and-use-the-browser-extensions-) to inject CSS changes without a page refresh._\n\n__Expand__\u003cbr\u003e\nCompile Sass using expanded output style for development by running:\n\n```bash\ngrunt expand\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpdevries%2Fgenerator-yomonger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpdevries%2Fgenerator-yomonger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpdevries%2Fgenerator-yomonger/lists"}