hpl3:3rdparty:codelite
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
hpl3:3rdparty:codelite [2012/04/04 10:23] jens |
hpl3:3rdparty:codelite [2015/10/06 07:04] jens |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== CodeLite - How to get started ====== | ====== CodeLite - How to get started ====== | ||
| - | - Download this zip as the current install on the offical website is out-of-date for Angel Script support. | + | //Alternate community created guide with images can be found here // //[[https://wiki.frictionalgames.com/hpl3/community/scripting/codelite_setup_with_pictures|wiki.frictionalgames.com/hpl3/community/scripting/codelite_setup_with_pictures]]// |
| - | - Copy extracted folder/lexers_hpl3.xml to "CodeLite install dir"/lexers/. This will add a language config for C++ we can tweak for AngelScript. | + | |
| - | - Launch CodeLite and configure: | + | |
| - | * Settings->Tags Settings->Display and Behavior: Increase number of items to display to 200. | + | |
| - | * Settings->Tags Settings->Display and Behavior: Activate "Keep function signature un-formated" this fixes our &in problem with hints. | + | |
| - | * Settings->Tags Settings->ctags->Include Files: Add a path to "SVN dir"/depth/redist/script, this will allow the parser to auto-parse script files that you #include among other things. | + | |
| - | * Settings->Tags Settings->ctags->Advanced: Add *.hps to file types list, this will allow the parser to parse .hps files. | + | |
| - | * Settings->Tags Settings->Colouring: Increase maximum number of coloured symbols to at least 5000. | + | |
| - | * Settings->Tags Settings->Colouring: Enable colour local variables. | + | |
| - | * (optional) Settings->Tags Settings->Colouring: Enable colour workspace tags, also enable enumerator but leave the rest with default setting. | + | |
| - | * (optional) Settings->Tags Settings: Configure the rest to your liking. For example, I enable auto-show & case sensitive. | + | |
| - | * Settings->Syntax Highlighting and Fonts->Change Coloring Scheme to HPL3 if not already set. | + | |
| - | - Create a new workspace. | + | |
| - | - Create a new project in the workspace. Use template Others -> None-code project. | + | |
| - | * Right-click on project folder, choose Import files from directory .. Import "redist/script/". | + | |
| - | * Right-click on project folder, choose Import files from directory .. Import "redist/maps/". | + | |
| - | * Right-click on project, New Virtual Folder, name it "_api". | + | |
| - | * Right-click on _api and Add An Existing File, add the file "redist/hps_api.hps". | + | |
| - | That should be it, .hps files should be color coded and parsed for completion as you added them to the project. If it did not, you can re-tag the workspace, project or the single file to see if it helps. If no color coding, it can be forced in View->View As: C++. You will know it uses our lexer if the strings are grey colored instead of red colored. | + | - [[http://www.codelite.org/LiteEditor/Download|Download the latest CodeLite release.]] |
| + | - Launch CodeLite and configure: \\ <nowiki>*</nowiki> Settings→Code Completion→Display and Behavior: Activate "Keep function signature un-formated". | ||
| + | * Settings→Code Completion→ctags→Search Paths: Add a path to "redist/script". | ||
| + | * Settings→Code Completion→ctags→Advanced: Add<nowiki> *</nowiki>.hps to file types list. | ||
| + | * Settings→Code Completion→Colouring: Enable colour local variables. | ||
| + | * (optional) Settings→Code Completion→Colouring: Enable colour workspace tags, also enable enumerator but leave the rest with default setting. | ||
| + | * (optional) Settings→Code Completion: Configure the rest to your liking. For example, auto-show & case sensitive enabled. | ||
| + | * Settings→Colours and Fonts→Customize, select C++ and in Global Settings add <nowiki> *</nowiki>.hps to the File Extension list. | ||
| + | - Create a new workspace. Do this by going to Workspace menu and select "New Workspace…". Pick C++ Workspace. Name is as you like and set the workspace path as you like **as long as it is on the same drive as SOMA.** | ||
| + | - Create a new project in the workspace. Do this by right-clicking on the workspace in the list to the left and choose the Create New Project option. Select others -> Non-code project. Name as you like and leave rest as default. | ||
| + | - Add one folder to the project. Right-click on the project folder and choose New Virtual Folder. Name it _api (you can create others later when you know more). | ||
| + | - Time to add files to the project. \\ <nowiki>*</nowiki> Right-click on _api and Add An Existing File, add the file "SOMA GAME FOLDER LOCATION/hps_api.hps" (might need to launch the game executable one time to have this file created). | ||
| + | * Right-click on the **project** in the list to the left, pick Import Files From Directory. Navigate to the SOMA GAME FOLDER and select it. In the next window, check the boxes for maps and scripts and make sure that the <nowiki>*</nowiki>.hps file extension is present in the list of extentions to import. Click OK. | ||
| - | ctrl-space will bring up the completion drop down. | + | That should be it, you should now have three top folders in your project and a lot of sub-folders with various script files. Hps files should be color coded and parsed for completion as you open them in the project. If they do not, you can re-tag the workspace, project or the single file to see if it helps. |
| - | ctrl-shift-space will bring up hints when inside the () of a function. | + | |
| - | ctrl-left-click on #include, variables, functions etc will open/move cursor to their location. | + | |
| - | ===== Issues & Info ===== | + | Start typing something, for example Entity (depending on configuration this can be case sensitive!) and a drop down should appear showing all the functions that begin with Entity and the documentation for each selected function. You can force things to appear using these shortcuts: |
| - | * Write Class@ object and not Class @object, the later will screw up coloring. | + | |
| - | + | ||
| - | * A bug currently can make some words loose coloring when you launch codelite. Open the Tags settings, click OK and the re-tag the file or project to fix it. | + | |
| - | * If you loose all coloring and can't get it back, delete the .tags file saved in the same folder as your workspace. Then relaunch codelite and re-tag workspace, save file to get it working. | + | * ctrl-space will bring up the completion drop down. |
| + | * ctrl-shift-space will bring up hints when inside the () of a function. | ||
| - | * Parameters with &in will break coloring of parameter, but will have no other side-effects. | + | ===== Issues & Info ===== |
| + | * Write Class@ object and not Class @object, the later will screw up coloring. | ||
| + | * A bug currently can make some words loose coloring when you launch codelite. Open the Tags settings, click OK and the re-tag the file or project to fix it. | ||
| + | * If you loose all coloring and can't get it back, delete the .tags file saved in the same folder as your workspace. Then relaunch codelite and re-tag workspace, save file to get it working. | ||
| + | * Parameters with &in will break coloring of parameter, but will have no other side-effects. | ||
| ==== Extra Info ==== | ==== Extra Info ==== | ||
| - | - Info about Settings->Syntax Highlighting and Fonts->Customize->->Edit Lexer keyword sets, Set 0 to Set 4: | + | |
| + | Info about Settings→Colours and Fonts→Customize→Styles→Edit Lexer keyword sets, Set 0 to Set 4: | ||
| * Set 0 User configured list of keywords not already parsed. Can be edited. | * Set 0 User configured list of keywords not already parsed. Can be edited. | ||
| * Set 1 Unknown. | * Set 1 Unknown. | ||
| - | * Set 2 Doxygen keywords, words here will be colored in comments using /** codeblocks when prepended with @ ie @var int myInt. Can be edited. | + | * Set 2 Doxygen keywords, words here will be colored in comments using /<nowiki>*</nowiki><nowiki>*</nowiki> codeblocks when prepended with @ ie @var int myInt. Can be edited. |
| * Set 3 Used for the setting "Colour workspace tags", automatically created (not visibly). Can NOT be edited. | * Set 3 Used for the setting "Colour workspace tags", automatically created (not visibly). Can NOT be edited. | ||
| * Set 4 Used for the setting "Colour local variables", automatically created (not visibly). Can NOT be edited. | * Set 4 Used for the setting "Colour local variables", automatically created (not visibly). Can NOT be edited. | ||
| + | |||
hpl3/3rdparty/codelite.txt · Last modified: 2020/02/10 16:21 by timan
