Major Categories: Add or reorder the Syntax sections.
Major Categories are used to group up similar syntaxtual functionality, such as loops, data types, classes.
Major Categories are used as headers to divide up the comparison page. If one of the two languages
does not have syntax for a particular section, that section will be omitted from the comparison
Minor Categories: Add or reorder individual syntax example names
Minor Categories are used to define specific instances of syntax within the relevant section. For example,
Data Types has minor categories for 'Value Types' (int, bool, string, ect), 'Initializing', and 'Type
Conversion'. All minor Categories are children of a Major Category section, and must be unique within
that section. The order of minor Categories is relative to that section, but by convention they try
to maintain the hundreds place to match the order of the major category.
Languages: Add new Programming Languages to the list
These represent the programming languages. (C, Java, Python, ect). Adding a new language to this list
will then let you start adding content to it in the Language Content section. Major and Minor categories
have to be added to each language manually, using said Language Content section. Languages are currently
not made public until they are directly toggled in the database. This allows users to work on populating
Language syntax over several days without pushing the results public until the work is complete.
Language Content: Gives an overview and allows editing of syntax examples for a language
This page initially shows the status of the Major and Minor categories as they relate to the language.
Clicking on the Major Category name, will filter the list of minor categories on the right.
Clicking on the Database row for a language can add that row if it does not exist.
Clicking on the 'Exist' row will toggle whether or not that syntax shows up in comparisons.
Note: You can still have commentary listed in sections which 'do not exist' for that language.
Clicking on edit will bring up the syntax content edit form for all of the syntax examples under
a Major category. The left side shows the C# equivlent template of what the code should look like.
The right side gives you a text area for each individual minor category, and a few buttons. Text in
the text area must me html formatted for how it will appear on the comparison page. this means users
have to manually add line breaks. See below for support for this...
Try Button: Will open up a new window that will display the text as it will appear when released
Add Button: This will add/update the code to the database. Each row must be individually added.
Exist box: This is used to toggle 'syntax exist'. You must use the Add Button to commit this change
Keyboard commands: There are a few keyboard commands to help with formatting...
Ctrl+B: Surrounds the selected text in bold tags
Ctrl+S: Surrounds the selected text with a 'comments' span. Used to make comments green
Ctrl+<: Enter the html encoding for left angle bracket.
Shift+Enter: Automatically adds html line break, as well as returning to the next line.