Bluefish

  1. Overview

    2. Bluefish is a free text editor. Under GNU / GPL v2 license, it's available for GNU / Linux and MS Windows.

    More informations on Bluefish : http://bluefish.openoffice.nl.

  2. Highlighting and auto completion

    3. Features :

    • Highlight of the Scol language keywords;
    • Highlight of nearly 1500 Scol functions. This option can be (de)activated in the Preferences;
    • Highlight of functions that you define (for example : non standard libraries). This option can be (de)activated in the Preferences;
    • Fold or unfold any blocks : functions or commentaries;
    • Highlight any parentheses, brackets and braces;
    • Automatic indentation when the Enter key (carriage return / line) is pressed after =, ( or {;
    • The auto-completion for nearly 1,500 Scol functions. This option can be (de)activated in the Preferences.

    Some screenshots that you can zoom in with contrasting colors (note that colors are customizable for the Preferences :

    screenshot 1 Colors, (un)fold functions blocks and auto-completion
    screenshot 2 Other example
    screenshot pref Preferences. At the bottom, you can change the style by a left click to the right column. At top, you can (un)check the Scol language options. At left, a part of the supported languages.
  3. Download and installation
    • Download :

      • Choose your prefered format and download it ! (73 ko uncompressed)

      - gzip (16 ko) : scol_highlighting.tar.gz.

      - 7zip (14 ko) : scol_highlighting.7z.

      - bzip2 (14 ko) : scol_highlighting.tar.bz2.


    • Installation :

      • Extractthis archive and copy the file named scol.bflang2 in the directory :

      - On GNU / Linux, /usr/local/share/bluefish/bflang/ (you should be 'root' or have the administratives rights);

      - On MS Windows, %INSTALL_PATH%/share/bluefish/ (%INSTALL_PATH% is thefolder where Bluefish is installed).

      Relaunch Bluefish.


    • Others informations : (to do ...)

      • * Vous pouvez changer le style affecté à chaque type de coloration en vous reandant dans les Préférences du logiciel. Dans la liste de droite, sélectionnez Langages puis Scol.
      Dans liste du bas qui s'est affichée, cliquez gauche dans la deuxième colonne et choisissez le type qui vous convient mieux. Voyez la 3e capture d'écran ci-dessus.


      * Pour changer les couleurs, allez dans les Préférences du logiciel. Dans la liste de gauche, cliquez sur Styles de texte et configurez les couleurs pour les types souhaités.


      * Pour activer ou désactiver une option (support de l'autocomplétion, des fonctions Scol et/ou des fonctions personalisées), rendez-vous aux Préférences du logiciel. Dans la liste de droite, sélectionnez Langages puis Scol. Cochez ou décochez les cases de la liste du haut pour, respectivement, activer ou désactiver une de ces options. Voyez la 3e capture d'écran ci-dessus.
      La description effective des options, bien que présente dans le fichier scol.bflang2, n'apparaît pas encore dans l'interface de la version 2.0.0 :

      - "load_completion" correspond à "Activer ou désactiver l'auto-complétion".
      - "scolfunctions" correspond à "Support des fonctions Scol".
      - "customfunctions" correspond à "Support des fonctions non standard" (fonctions personnelles, librairies, ...).


      * Pour ajouter des fonctions personnalisées à la coloration et à l'autocomplétion, éditez le fichier scol.bflang2 (droits d'administration requis si vous êtes sous GNU / Linux) et ajoutez-les dans le groupe "customfunctions", tout en bas du fichier, en suivant l'exemple fourni. Enregistrez et relancez Bluefish.


      * Bluefish se base sur les types MIME des fichiers pour attribuer la coloration syntaxique. Cette détermination se base sur les données fournies par le système d'exploitation. Les fichiers *.pkg n'étant pas associés en standard aux packages scol, il se peut que la reconnaissance par Bluefish soit erronée. La coloration ne se fait pas ou c'est celle d'un autre langage. Pour pallier à ce désagrément, deux solutions :
      - indiquer manuellement à Bluefish le bon langage : allez au menu "Documents" puis "Langages" et sélectionnez "Scol". La bonne coloration sera immédiate mais ce sera à refaire pour chaque fichier pkg ouvert.
      - modifier le type MIME défini dans le fichier scol.bflang2. Éditez-le (droits d'administration requis si vous êtes sous GNU / Linux) et changez la valeur de l'attribut "type" de la section "mime" (au début du fichier) avec la valeur appropriée, définie par votre système. Attention cependant, si le type MIME défini par votre système est commun à un autre langage (cas fréquent avec le C/C++), il pourra y avoir conflit dans la coloration.


      Vous pouvez définir le type MIME des fichiers *.pkg comme suit (sur GNU / Linux et avec un environnement GNOME) :
      rendez vous dans le répertoire /home/votre_login/.local/share/mime/packages (il s'agit d'un répertoire "caché") et modifiez (ou créez s'il n'existe pas) le fichier user-extension-pkg.xml avec une valeur du type :

      Dans un terminal, exécutez ensuite :

      $ update-mime-database ~/.local/share/mime/

      Cette manipulation est à effectuer avec prudence et ne devrait être réalisée qu'en sachant vraiment ce que vous faites.

  4. Highlight for version 1.x

    5. From my old tutorial, based on version 1.04.

    Go to Edit menuand select Preferences.

    1. Configuration : file type
      • Choose tab "Files types" :
        type de fichiers
      • Below field "Files types", click ton "Add"
      • At the bottom (scroll), a new enter named "untitled" has been created. Double-click inside to give it a name : "scol"
      • Double-click on the next column ("Extensions") : add the Scol packages extensions : ".pkg"
      • All right :)
    2. Configuration : highlight
      • In the Preferences, go to tab "Syntax highlighting"
      • In the combo, choose "Files types" > "scol"
      • Enter the Scol syntax per group (see image below) :
        coloration syntaxique
        For example, to put the keywords with style bold and color red :
        no end model,
        start model : \b(fun|proto|struct|typedef|var|typeof|\;;)\b (voyez la construction ...)
        foreground color '#FF0000'
        Entrez le nom du groupe (par exemple 'keywords') et appuyez sur Ajouter. Recommencez pour chaque groupe
      • Pour colorier les commentaires entre '/* --- */' :
        Le modèle ne comporte pas de fin
        Début de modèle : /\*.*?\*/
    3. Click on "Apply", test it. If ok, click on "Valider".

    Note : Pour rafraichir la coloration syntaxique d'un fichier ouvert sous Bluefish, appuyez sur la touche F5 du clavier.

    Note 2 : La même manip' peut être utilisée pour coloriser les fichiers .m3d !