SQF Syntax for Brackets
Sqf Syntax for Brackets is a plugin for the code editor Brackets. It is a open source editor which is hackable by nature and available on github. this plugins goal is to offer syntax highlighting to make working with and reading sqf files easier. providing a autocomplete/code hint on All keywords in the sqf language for Arma3 (currently only arma3 but arma2 syntax is possible if high demand, i would have to put some kind of button to toggle between them and have it save).and to quickly provide the documentation on bohemia wiki to make understanding and learning how to use keywords easy without needing about a million tabs open in chrome.
Syntax highlighting (all arma3 keywords are highlighted)
Autocomplete (automatically gives code suggestions which are ordered by word length)
Quick documentation (right click and select "quick docs" or ctrl + k. while having a word selected to bring up)
Quick links to bohemia wiki for keywords (including the see Also suggestions)
This image shows where to click to open plugin manager to install the plugin just search for "sqf syntax for brackets".
note the second line of syntax which says "(Alternate Syntax exists check Read more)". is their because the bohemia wiki has 2 different syntax's with different params and returns available. and for simplicity of the quick doc it was dropped and a reference was left instead. do note that the secondary syntax is used in the examples of every file this happens in and in most cases doesn't require looking at the wiki
Image demonstrating all features:
the see also section was blank because "private" has no other related keywords. here's a better demonstration of the syntax highlighter and the see also section of the documentation
the "Read more" button is a link to the bohemia wiki on the keyword. and the donate button is a paypal donation link for anyone who feels like donating.
Tips for Beginners:
- download and install brackets from Brackets.io
- Open the plugins manager from the right hand panel and search "SQF Syntax for brackets"
- press install and your done.
if you are new to coding in SQF the first thing id recommend you do. is open up someone elses work. and read and workout how it works. and whenever you see words that you dont understand exactly what it does, this plugin will make it very easy for you to see exactly what it does without looking away from the editor. once you have a basic understanding and also understand how "call" & "spawn" work with passing in paramaters. then you can make ur first function / file. And learn to split your code logic up. so that each file / function performs one task and is named and documented appropiately. which will help greatly when your codebase starts to grow huge and you need to look for whatever does x feature. remember that the first goal is to master the syntax of the language you are using, so you can efficently make whatever it is you want. this takes reading and practice. and make sure to always focus on reading information about the syntax of the language before trying to learn advanced techniques. Bohemia Scripting Wiki
After heavily leveraging that website to quickly learn sqf i was up and going in a weekend making heaps of things. i do understand i am a seasoned programmer from multiple languages which is why i thought id make this advanced editor plugin to give back to this pretty awesome community and help those out who are new to learning a programming language. (i wish i had this plugin when i started could of probs learned sqf at a much faster rate, one of the hardest things was realising what their is actually keywords for to do the things i wanted to do).
Any feedback / error reporting / feature request would be greatly appreciated, ill try and look at the forums as often as i can but i doubt i will super often, so instead please submit a issue / feature on the github page