title: Custom syntax in Sublime Text 3
body: <p>I'm struggling to find out how to create a new syntax highlighting in Sublime Text 3 using the new <strong>.sublime-syntax</strong> style definition (most previous answers relate to old ways of doing it).</p>
  
  <blockquote>
    <p>As of Sublime Text Build 3084, a new syntax definition format has been added, with the .sublime-syntax extension.</p>
  </blockquote>
  
  <p>I can find the:</p>
  
  <ul>
  <li><a href="https://www.sublimetext.com/docs/3/syntax.html" rel="noreferrer">syntax rules</a></li>
  <li><a href="https://www.sublimetext.com/docs/3/scope_naming.html" rel="noreferrer">scope naming rules</a></li>
  <li><a href="https://www.sublimetext.com/docs/3/color_schemes.html" rel="noreferrer">colour scheme rules</a></li>
  </ul>
  
  <p>But I can't find the most basic piece of information detailing how these tie together!</p>
  
  <p>I'm not trying to create a theme, or tweaking an existing syntax definition. I just want to create syntax highlighting to files with an extension I plan on using for my own purposes. </p>
  
  <ol>
  <li>In the syntax definition I have to specify a scope (e.g. <strong>scope: source.c</strong>) but where does that scope file live? Or rather, where do I create my scope file, and how do I name it, so that it loads? </li>
  <li>How do I know that my syntax file, and the scope file it uses, are loaded and applied successfully?</li>
  <li>Are there any compile or refresh steps, or does everything automatically reload?</li>
  </ol>
  
  <p>Thanks.</p>