{"id":17178528,"url":"https://github.com/bobbylight/tokenmakermaker","last_synced_at":"2025-04-13T17:10:50.909Z","repository":{"id":10003425,"uuid":"12038049","full_name":"bobbylight/TokenMakerMaker","owner":"bobbylight","description":"An application to easily create highlighting for custom languages for RSyntaxTextArea.","archived":false,"fork":false,"pushed_at":"2023-06-02T23:22:02.000Z","size":1957,"stargazers_count":7,"open_issues_count":5,"forks_count":10,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T08:01:47.928Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bobbylight.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-08-11T15:40:07.000Z","updated_at":"2023-10-30T22:47:24.000Z","dependencies_parsed_at":"2022-08-28T20:40:09.086Z","dependency_job_id":"bd6af7f0-df5b-41ce-96f9-7d0a60db894c","html_url":"https://github.com/bobbylight/TokenMakerMaker","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/bobbylight%2FTokenMakerMaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobbylight%2FTokenMakerMaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobbylight%2FTokenMakerMaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bobbylight%2FTokenMakerMaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bobbylight","download_url":"https://codeload.github.com/bobbylight/TokenMakerMaker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248750107,"owners_count":21155686,"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-15T00:07:36.713Z","updated_at":"2025-04-13T17:10:50.881Z","avatar_url":"https://github.com/bobbylight.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TokenMakerMaker\nTokenMakerMaker provides a simple GUI interface that allows you to define a\nprogramming language.  It can then generate a `.flex` and `.java` file that\n`RSyntaxTextArea` can use for syntax highlighting that language.  This removes\nthe need for you to learn JFlex and/or the (mostly undocumented) manual tweaks\nyou need to do to JFlex output to make it usable in RSyntaxTextArea.  The\ntrade-off is a lack of flexibility: `TokenMakerMaker` can be used to define most\nbasic language constructs (comments, keywords, strings, etc.), but it doesn't\nexpose the full power of what you can do with JFlex (nor will it ever try to).\n \nUnlike all other RSTA projects, this one requires Java 14.  Since this library\nis a tool, and not something other applications would be dependent on, this is\nnot an issue.\n\n\n## Dependencies\nAll dependencies are pulled in via Maven with the included Gradle build script.\nThe version of RSyntaxTextArea built against can be changed by updating its\ndependency.\n\n\n## Building with Gradle\nTo build use this project's gradlew wrapper to create `TokenMakerMaker`.\n\n```bash\ncd \u003cproject-root\u003e/TokenMakerMaker\ngradlew --refresh-dependencies\ngradlew clean build installDist --warning-mode all\n```\n\n## Using\n1. Run class org.fife.tmm.Main from Eclipse.  No other work required.  OR...\n2. After building with Gradle (see above), from the command line:\n\n```bash\ncd \u003cproject-root\u003e/build/install/tmm\njava -jar tokenMakerMaker-${version}.jar\n```\n\n\n## Usage Notes\nThe app is just a simple dialog with tabs for different \"parts\" of the\nTokenMaker you are creating - general info, comments, keywords, etc.  I think\nthe general usage should be self-explanatory, but here are some things to note:\n \n1. You can save and load your progress via Ctrl+O/Ctrl+S.  Your TokenMaker\n   spec. is saved in an XML file.  This way you can come back and work on it\n   later if you want, without having to dig into the generated flex.\n \n2. Once the app starts, the first thing you'll want to do is go to\n   File -\u003e Options.  You'll want to provide correct values for the fields in\n   the \"General\" panel:\n   \n     - The full path to javac (javac.exe on Windows).  If TMM is launched\n       with a JDK instead of just a JRE, this should be pre-filled in.\n       Otherwise, you'll have to specify one yourself.  If this is left blank,\n       then TMM will generate the .flex and .java files for your TokenMaker,\n       but it will not be able to generate the corresponding class file, and it\n       won't be able to launch the \"preview\" editor to try out your TokenMaker.\n       In this case you'll be notified when clicking \"Generate\" about the need\n       to configure the javac location to use this functionality.\n      \n     - \"Source output directory\" is where TokenMakerMaker will place the\n       generated .flex and .java files.  You can point this directly to a\n       source directory in your project, for example.\n      \n     - \"Class output directory\" is where TokenMakerMaker will place the\n       generated .class file when it compiles it for the editor preview.\n       You can point this to your \"bin\" or \"classes\" directory in your\n       project, or you can simply point it to `C:\\temp` or `/tmp`.\n\n   I believe old files with the same name will be overwritten without\n   prompting you if it's okay, so be warned!  =)\n \n3. On the \"General\" tab, the difference between \"C-derived syntax\" and\n   \"All others\" is that the former will cause your TokenMaker to auto-indent\n   after lines ending in `'{'`, as well as auto-align closing `'}'`\n   chars when they are typed (assuming auto-indent is enabled in the\n   RSyntaxTextArea it's running in).  It's supposed to be the option you want\n   to pick if the language you are creating derives syntax from C, and uses\n   curly braces to denote code blocks.\n \n4. The app is supposed to be smart, and if you don't enter a value for a field\n   that is required, you shouldn't be able to generate anything without an\n   error prompt.  But there may be issues I haven't discovered yet.\n \nSo anyway, it's just something to play around with.  Let me know what features\nyou'd need in addition to what's already there - there are many possibilities -\nvalid number formats, whether escapes are allowed in strings, multi-line\nstrings...  And of course report back any bugs.  Keep an eye on the console\noutput when you're running and look for anything dubious.  =)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobbylight%2Ftokenmakermaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbobbylight%2Ftokenmakermaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbobbylight%2Ftokenmakermaker/lists"}