Empty Block

Obtain Funcdown Source

Download Instructions
Extension files
Highlighters
Copy, Paste and Save by Hand

Undoubtfuly, You will need a directory with particular name on Your hard drive, that should be accessible via preffered http server. PHP built-in server will do the job perfectly (if You don't have Apache or similar installed) ... anyway, for the sake of the following steps below, we will use $docroot variable as installation location, where $docroot may represent real $_SERVER['DOCUMENT_ROOT'].

  1. Create new sub-directory with name source under Your chosen $docroot location.
    eg: mkdir $docroot/source

    Note that it doesn't need to be `source`, it can be `fncd` or `fncd_depfiles`. If You decide to change basename into some other instead of default `source`, that action requires changing the first argument in Test/caller file as well (read the comment there). Nonetheless, variable $funcDir will point to `source` in this example.

  2. Create one more sub-directory with name .conf.d - inside previously created $funcDir sub-directory.
    eg: mkdir $docroot/$funcDir/.conf.d

  3. Click on Extension Files tab in the top-middle portion of this box, and there You will see 4 tabs where each ones content is a raw source code (file) content. The below table tells which tab content (source code) goes into which file. That is how You are going to create and name all four of them, as it is proposed with bold text under Target File. Note that Test/caller doesn't need to be index.php, name it funcdown-test.php if You wish, or if You already have an index.php in chosen directory tree.

    Tab Content Target File
    Test/caller $docroot/index.php
    ObjectInstance $docroot/$funcDir/ext.php
    Library $docroot/$funcDir/lib.php
    Config File $docroot/$funcDir/.conf.d/.funcdown.conf.ini.php

  4. Once when You have all four files (UTF-8) ready,
    repeat the following for each Tab Content:

    • Click/focus onto source code
    • Press CTRL + a (select all), then press CTRL + c (copy selection)
    • Open corresponding, previously created file (make sure it is - blank)
    • Press CTRL + v (paste source) into and save file.

  5. Once when You are finished with all 4 Tabs, You can test what You have done via browser url.

    • If You have apache or ngnix configured and running,
      than just load: http://localhost/test_caller_file.php from the browser url bar.

    • In case You have only php-cli installed, than something like this from Your terminal.
      Assuming that You are using GNU/Linux or Mac

      php -S localhost:8080 -t /directory/where/test_caller_file_is

      and than load: http://localhost:8080/test_caller_file.php

Outcome

If all goes well, this is what You should see on screen:

  • buster
  • m$

Test output on the images above is older than the current rolling funcdown version output (some properties have changed, etc.), therefore it will differ a bit from what You see on Your own screen, but in general, those images still reflect successfull outcome.

Syntax Highlighters

If You find Funcdown amusing or handy, You may want to have code coloring for it, while writing funcdown code. Syntax highlighting in other words. If You do, there are only two editors supported for now. Sublime Text Editor and Ace Editor.

  • Click on Highlighters tab (top-right portion of this page). That would reveal two more additional tabs. One for Ace and the other for Sublime-text editor.

  • Ace Editor highlighter

    1. Copy the entire contents of the tab code. (ctrl + a then ctrl + c)
    2. Create new file called mode-funcdown.js under the Ace root directory (you'll see a lot of other mode-*.js files there), paste the clipboard contents (the previous step), save the file - and that's it!

    From this point, Ace should know that there is mode-funcdown available and will highlight Your Funcdown code automatically, by giving configuration parameter, something like editor.session.setMode("ace/mode/funcdown"). Ace provides more options and functionallity for each and every mime/file type extension. You may want to refer to Ace online docs on how to add funcdown extension to the main drop-down menu, automatic extension detection, etc.

  • Sublime-Text Editor

    Copy tab contents *(just like with Ace Editor) and save under the correct location with proper name *(eg: funcdown.sublime-syntax), and that should do. In general, Sublime-Text Editor is STATE OF THE ART *(in every way) code editor, and modifying or extending its functionality is a - breeze.

    If You have any kind of issues with custom syntax implementation, take a look at THIRD line, on the Sublime Text Editor tab.
    Make Your self a cup of coffee and read what it says on their Custom Syntax Documentation Page.

Test/caller
ObjectInstance
Library
Config File
index.php >> (session expired, please reload this page)

Last modified @ 2024-01-05 07:38:18+01:00

ext.php >> (session expired, please reload this page)

Last modified @ 2023-11-20 13:35:12+01:00

lib.php >> (session expired, please reload this page)

Last modified @ 2023-12-14 21:13:34+01:00

.funcdown.conf.ini.php >> (session expired, please reload this page)

Last modified @ 2023-12-12 03:55:59+01:00

Ace Editor
Sublime Text Editor
mode-funcdown.js

Last modified @ 2023-12-21 11:58:15+01:00

funcdown.sublime-syntax

Last modified @ 2024-02-11 00:58:09+01:00

Empty Block
Empty Block
Empty Block
Empty Block