Nondigestible Purple Mayonnaise

    coditor

    1.1.0 • Public • Published

    Coditor

    NPM Downloads

    See CHANGELOG to see more about recently changes.

    Important

    If you are interested in the old version, please select coditor-old branch in this repo. if there is something that you think needs to be add on coditor, open an issue to have a discussion about that.

    Introduction

    Coditor is a multi-tab code editor as a component with extra features, now based on vue.js and codemirror.js

    Features

    • Support a programming language for each tab (see here a list supported by codemirror)
    • Optional, making web request and handle response using vue-resource
    • Select a theme via setting for each tab or a single theme via a global setting for all tabs. (see here a list of themes for codemirror). Coditor has its own theme called with the same name. By default it is set this theme, but you can customize this theme or select other theme.
    • Hack this webcomponent and customized with its own features.
    • Now you can work in mode development or generate assets for production. This is possible thanks to vue-template that containt several developement enviroments (test, build, dev)

    Try online

    click here

    Install

    1. Install coditor
    npm install coditor --save
    1. Install dependencies and dev-dependencies
    cd coditor && npm install

    Test in development mode

    npm run dev

    Your browser will be automatically launch into http://localhost:8080. By default is set javascript language, but if you need to add a new language, You need to add some line codes in main.js. See how to customize coditor.

    Customize coditor for building assets

    You need to customize your own preferences for coditor. This include:

    • switch to another theme if you want (by default coditor theme) (optional).
    • add new themes for each tabs (optional).
    • add libraries for each programing languages that will be supported to your specific requirements.

    Switch to another theme (for all tabs)

    1. Import theme into main.js inside the src folder.
      • all themes are inside node_modules/codemirror/theme/ So, you must import like any other js module. For example:
      //import monokai theme
      import monokai from 'codemirror/theme/monokai.css'
    2. Change the value of theme into config.json inside the src folder to the new value (monokai).

    Add a new theme (for each tabs)

    1. See literal 1 of Switch to another theme. You must import each themes that you want to use.

    2. You must specified for each props the theme that you want to use. (see props for coditor)

    Add libraries for each programming languages

    1. Into main.js inside the src folder you must import each library that coditor should be supported. See here all modes that support codemirror. For example:
    • Example 1: Add support for c, c++ and c# s
    import clike from 'codemirror/mode/clike/clike.js'
    • Example 2: Add support for php
    import php from 'codemirror/mode/php/php.js'
    1. Add in window object each mode (into main.js inside the src folder):
    internals.loadCodeMirror = (() => {
      window.CodeMirror = Codemirror
      window.modejs = modejs
      window.clike = clike
      window.php = php
      // add support to a new programming language
    })()

    Now, you can specify in props what programming language will be use for each tab.

    How to use request handle with ajax using vue-resource (optional)

    Into config.json you must specified a type request (get, post, etc) and url. There are others settings for vue-resource (see here more settings and type of request)

    In development mode you can test this option. When you click get the current editor information button you will be receive a response of the server and will be show in console. (only for methods get and post)

    Build assets

    Use npm run build to build the project minified version. Inside the dist folder will you have minified assets.

    How to use coditor in your app

    If you already built assets, continue with the tutorial. If you haven't already done so, please see how to customize coditor.

    1. Into your html page of their app should add the coditor tag on the html body and assets that was generated.
    <!DOCTYPE html>
    <html>
     
      <head>
        <meta charset="utf-8">
        <title>coditor</title>
        <link href=/static/css/app.bcbf3089697ef644d789a2bd1d4034b1.css rel=stylesheet>
      </head>
     
    <body>
        <coditor></coditor>
        <script type=text/javascript src=/static/js/manifest.dc23b23c8948b8e3b634.js></script> 
        <script type=text/javascript src=/static/js/vendor.23969caa477a638a5a0a.js></script> 
        <script type=text/javascript src=/static/js/app.9219903ee545d47d5660.js></script> 
    </body>

    Now, you can execute your application and by default you will see only one tab with the options that you configured into config.json.

    minimum props

    type key value
    [string] name a name whatever
    [string] mode language programming

    If you want init with a piece of code, you must specified a third key:value in the configs:

    type key value
    string value piece of code

    See below the basic and advanced settings.

    Basic setting for each tab

    To a basic configuration for each tab, you must specified minimum two values. (name and mode)

    • Create a script tag and into window object add new javascript object called coditor and on coditor object add a new value type array that containt settings for each tab. Example:
    <script>
      window.coditor = {}
      coditor.cfg = [{
        name: 'Tab 1',
        mode: 'javascript'
      }, {
        name: 'Tab 2',
        mode: 'text/x-java'
      }];
    </script>

    Advanced setting for each tab

    To have more control over the each tab, see here all configuration options for codemirror. (By default, theme is set with coditor theme and lineNumbers is true, but you can changes this values)

    Example advanced setting:

    <script>
      window.coditor = {}
      coditor.cfg = [{
          name: 'Tab 1',
          value: 'function holaMundo () {\n  var name = "Coditor";\n  console.log(name);\n  console.log("at has been replaced");\n}',
          mode: 'text/javascript',
          lineNumbers: false
        }, {
          name: 'Tab 2',
          mode: 'text/x-java',
          theme: 'monokai'
        }];
    </script>

    window.coditor object

    window.coditor object containt two values:

    • cfg: [array] that containt props
    • value: [object] containt data about the information that was captured when clicked button (get the current editor information)

    whether you specified http config or not, also will be have the value information that was captured when clicked button get the current editor information.

    Screenshots

    image1 image2 image3

    Contributing

    You are welcome to contribute to this repo with anything you think is useful. fixes are more than welcome.

    Support

    If you need help using coditor, or have found a bug, please create an issue on the GitHub repo

    License

    MIT Licence

    Install

    npm i coditor

    DownloadsWeekly Downloads

    0

    Version

    1.1.0

    License

    MIT

    Last publish

    Collaborators

    • davidenq