HAPedit 3.1

On this page, you will find some information about HAPedit.
Last update and a lot of screenshots are on the web at:
http://hapedit.free.fr/


1. HAPedit
2. Download
3. Html
4. Asp
5. Php
6. Editor
7. More!
8. Requirements
9. Translation
10. Link your site
11. EMail me
12. FAQ list
13. Add-Ons Description
14. Multi-User Mode
15. Development languages
16. Shortcuts
17. User filter
18. Templates
19. Known problems
20. Terms of use
21. Miscellaneous

1. HAPedit

HAPedit is an acronym for Html Asp Php editor; a win32 text-mode editor useful for all developpers of dynamic web pages.

Its main features are: syntax highlighting for html/php, html/asp, html, JavaScript, CSS and SQL; page preview in browser; project manager; php code "compilation"; edit html tags; code completion; preview images; SQL console; FTP Manager; Code Explorer and more.

(This is freeware)


top of the page

2. Download

Installation: Upgrade:
Use add-on 'SmartUpdate', in menu Tools -> Add-ons.
It will download and install only upgraded modules (between 4 and 7 clicks).

top of the page

3. Html

HAPedit offers a simple but efficient interface for creating and editing HTML tags.

Tool bar buttons allow you to choose and insert tags quickly.
To edit a tag, use Ctrl+E on the keyboard or double-click with mouse into tag code.

Html development is facilitated with syntax highlighting and code completion.
Code completion is an assistant which appears while you type to offers to complete the current word for you.

In an html tag (eg: blockquote, table) Ctrl+F1 can provide a description of the current tag.
Help may be a file in .hlp format or a folder with .html files like those used by DreamWeaver.

Editor shows code in text-mode, and uses your browser to preview pages.
You can define several browsers, in order to check quickly display compatibilities directly from HAPedit.


top of the page

4. Asp

Asp management doesn't work as well it does in php, because HAPedit can't catch the error codes returned on compilation.

Syntax highlighting asp/html is one of the main features, In addition, code completion is available for Asp as it is for HTML. Furthermore, HAPedit is shipped with the following development languages: Asp, ADODB and VBScript.

In the 'Page' menu, the function 'Insert file', allows you to add an 'include' directive with selected file name.

Alt+F2 Display window with code explorer.
Shift+Ctrl+B inserts a "<% %>" tag.
Shift+Ctrl+C converts the selected text into a comment.
Shift+Ctrl+P converts double-quotes from string chars into special double-quotes.

In string chars, e.g. '<% Response.Write("...', you can access all html functions. This means that you can edit/insert html tags in string chars, using the HAPedit interface.


top of the page

5. Php

Php management works fine, because HAPedit can catch compilation return codes.

Ctrl+F9 returns compilation error in php pages if you have the php engine installed.
Remark: you can compile php code without using a server but directly using php.exe (See: Option "php direct").

Syntax highlighting of php/html is one of the main features, but as for html, code completion is also available, to propose completion of functions or php variables as you type. Futhermore, editor popups code hint (php parameters of php functions).

'Brace-matching' highlights blocks '{}', '[]' and '()' while typing code. Shift+Ctrl+K highligths all block. Alt+Up and Alt+Down move cursor to extremities of the block.

With the cursor positioned on a php function (eg: echo, mysql_connect), Ctrl+F1 displays the page of php manual that describes function. You do this on-line or off-line if you download the manual (chm format is recommanded but 'Many HTML files' format is still supported).

In the 'Page' menu, the function 'Insert file', allows you to add a 'require' directive (or 'include') with selected file name.

Alt+F2 Display window with code explorer.
Shift+Ctrl+B inserts the "<? ?>" tag.
Shift+Ctrl+C converts out selected text.
Shift+Ctrl+P escapes double-quotes in a string (that converts " to \").

In strings, e.g. '<? echo("...', you can access all html functions. This means that you can use the HAPedit interface to edit/insert html tags into strings.


top of the page

6. Editor

The editor, with its multi-document interface, functions in text-mode, and uses your browser(s) to preview pages.

As you write code, you can call one of the page-checking functions to check for broken links or missing images.
You can extract code for images or links, to check them individually; all extractions are made after a 'compilation' for dynamic languages, such php or asp.

By "compilation", I mean generating the html code; this is similar to when you view source code in your browser: dynamic code is changed into html language.
This is possible, if you have a local web server (Apache, IIS or PWS) running on your machine.

Compilation is also used (automatically) to compute download time of current edited document.

All functions calling 'compilation' can be executed with a QueryString.

In addition to the code completion, code template allow you to insert quickly a block of code that you definied.

Text search/replace can be in current document, opened documents or project documents, with options such as regular expression (POSIX) and files mask ("*.php?;*.inc").


top of the page

7. More!

Integrated project manager, with a Windows Explorer style interface, allows you to browse in folders of your projects.

First of all, projects manager allows to open a file quickly, but also to preview images or launch a browser with the selected page.
A button lets you launch Windows Explorer any time for the selected file or folder. In addition, right-click on any item list to display a contextual menu or Windows properties.

Explorer interface also allows:
- add and setup your personal tools in main menu, (see below)
- add and setup development languages user data,
- add browsers to preview your pages.

But also:
top of the page

8. Requirements

Minimum configuration for your computer is:

I think your configuration starts to work fine with:

But warning, in all cases you will need good knownledge of html...


top of the page

9. Translation

Your help will be welcome if you speak another language and you have some time to give me:

to translate HAPedit
HAPedit already exists in several languages, but if you want to see it translated into your language, it's possible.
If you agree, I will send you instructions and some files to translate.
 
to translate this site
It's the same thing for this site. It can support many languages and you can translate it too!
The process is the same: files, instructions, translation.
 
to manage a newsletter
You can be an "official ambassador" of HAPedit in your language, by managing a newsletter.
You will receive email before subscribers; then you will have time to translate it and add your comment before I announce to you by a second email that the official broadcast is ready; (that is, when new version is available to download for everyone).
Notice: your subscribers will able to download some beta versions.
 

Of course you will do this job freely, HAPedit is freeware!

At this time, some users are translating HAPedit.
You will be welcome to help translators:
LanguageHAPeditWeb Site
  1. FrenchOriginal Language
  2. English-USDone!Done!
  3. SpanishDone!93%Stopped
  4. GermanDone!83%Stopped
  5. BrazilianDone!5%Stopped
  6. ItalianDone!Done!
  7. DutchDone!30%Stopped
  8. Traditional ChineseDone!-
  9. Norwegian37%Stopped-
10. Simplified ChineseDone!-
11. PolishDone!-
12. Hungarian55%Stopped-
13. English-UKDone!-
14. Danish58%Active-
15. Czech53%Active-
16. Swedish28%Active-
17. Turkish11%Stopped-
18. BulgarianDone!10%Active
19. Esperanto53%Active-
20. Indonesian7%Stopped-
21. Romanian90%Active-
22. Valencian13%Active-
23. Macedonian (beta)Done!50%Active
24. Malay20%Active-
25. Russian18%Active-
26. Japanese18%Active-
27. Slovakian7%Active-
28. Albanian35%Active-
Updated: May 26th, 2004

To get in contact with me: See Menu: Help | Informations | EMail the author.

top of the page

10. Link your site

If you want make a link on your site to HAPedit, here some suggestions:

URL :
http://hapedit.free.fr/
 
Download :
http://hapedit.free.fr/downloadex.php?file=hapedit.zip
(This link will be always available)
 
Short text:
HAPedit is useful for all developers of dynamic web pages who need a text-mode editor.
 
Long text:
Main features are: syntax highlighting for html/php, html/asp, html, JavaScript, CSS and SQL; display result in browser; projects manager; php code "compilation"; edit html tags; code completion; preview images, SQL console, FTP Manager, Code Explorer, and more.
 
Icons :
<img src="http://hapedit.free.fr/images/htsmall2.gif" alt="HAPedit" width="16" height="16" border="0">
<img src="http://hapedit.free.fr/images/hapedit.gif" alt="HAPedit" width="32" height="32" border="0">
 
Thank you!
 

top of the page

11. EMail me

See Menu: Help | Informations | EMail the author


top of the page

12. FAQ list

How to indent a text block?
Select text to indent, then
- TAB indent block on right,
- Shift+TAB indent block on left.
How to deactivate tab chars replacement?
You can't; HAPedit doesn't work when there are tabulation chars in code. They will be replaced every time.
But, this is not definitive; I will change this odd thing...
Why does "Close all" leave one open document?
In Options, "Files" tab, there is an option "Always keep one opened document".
How to specify username and password to my proxy server?
In Options, tab 'Connection', field 'Proxy address', use following format:
http://user:password@proxyurl/
If you must specify, only username:
http://user@proxyurl/

Then, you could find:
http://mylogin:mywd@www.anonymizer.com/ or http://monlogin@www.anonymizer.com/
Why does php code compilation ignore the "QueryString"?
"QueryString" only works if you compile through the server and not directly with "php.exe".
In Options, "Php" tab, option 'Use local server'. (instead of 'php direct')
How to wrap long lines automaticly?
Option 'word wrap' doesn't exist in HAPedit.
You have to do this by hand.
Why editor fonts choice is limited?
HAPedit editor only works with 'fixed pitch' fonts. This property sets the same size to 'i' and 'm' char that allows correct indentation in code.
Is a Linux version planned?
Yes, I think about it; I just start with Kylix and Linux...
ASP/PHP code completion doesn't work with "include" files?
Yes, it goes to search defined variables into files called with "require", "include", etc. It works if HAPedit is able to resolve the relative pathname to the file. To resolve a relative pathname, you have to provide the "root" folder of your project, this is the pathname where are located the ASP/PHP pages with directives "require" or "include".
See Menu: File -> Root folder

top of the page

13. Add-Ons Description

Add-ons are separated components; you will download a module at run-time at their first startup.
(See SmartUpdate to upgrade them)

You launch Add-Ons since Menu: Tools | Add-ons.
You can also add a button in toolbar; see Menu: Options | ToolBar.

Before uninstall, read recommandations below this page to be sure you will let nothing.
 

Add-Ons are:
SmartUpdate:
Allow to upgrade program through Internet connection.
It downloads application and re-installs the add-ons from last release (or downloads their new release).
Downloaded files are stored in subfolder 'Updates' in HAPedit.
It's highly recommanded to use it to upgrade HAPedit.
 
FTP Manager: (FTP Client)
Allow to send projects files on the web.
It is not a console; it's a file explorer look-like, with two lists.
 
Archiver:
Allow to archive project with 7 clicks.
 
iCoBoX:
Allow to create .gif from icons (.ico, .icl, .exe, .dll).
 
Shortcuts/Explorer:
Add in Windows explorer, "HAPedit" in right-click menu, on file type who defined in HAPedit options.
Allow to add too, shortcuts to HAPedit at several locations.
Use this add-on to complete your installation.
 
Uninstall recommandations:

Only the add-on 'Shortcuts/Explorer' writes datas out of HAPedit folder.
If you are sure that you didn't use it, then jump to step 6.

  1. Run add-on 'Shortcuts/Explorer'
  2. Select all options in each sheet
  3. Select operations 'Remove ...' in each sheet
  4. Click on 'Apply'
  5. Close the window
  6. Close HAPedit
  7. Delete file 'ht_adds.bin' located in HAPedit folder.
Remark:

I'm looking foward all ideas for new add-ons, and perhaps integrate one of your program.
I'm working on a CSS editor.
 


top of the page

14. Multi-User Mode

"Multi-user" mode allows several users to share a single installation of HAPEdit.
This is only possible beginning with version 3.1

It is possible to share over a network or simply between multiple users of a single machine.
In either case, each needs to have his or her own Settings folder. To find out where your Settings are stored, go to Menu: Information → Environment → "Settings Folder".

Your privileges when running and updating HAPedit depend on the privileges you hold over the folder where HAPedit is installed:
- 1) Read + Write (non-networked)
The highest level. You have access to all functions:
You can download new modules and run upgrades using Smart Update.
You are the Super Administrator, the only one allowed to run Smart Update.
- 2) Read + Write (over the network)
The "classic" Administrator level. You can download new modules (Add-ons and Languages).
These modules will be available immediately to all users.
- 3) Read Only
The User level. You can only use modules already downloaded and installed by an administrator.
No other restrictions.

Note to administrators

An administrator can set certain default configuration settings for new users who will be running HAPedit for the first time. In general, this allows for the configuration of the network resources. For example, the administrator can set the "Document Root", a list of projects on the network as well as the location of help files such as the PHP manual or HTML help files.
These settings are defined in the HAPedit installation folder in the "network.ini" file. To see a list of the settings that can be defined as defaults in this way, consult the "network.ini-dist" file, which is distributed in the .zip archive.
In summary:
- Only new users read this file. It does not affect the settings of existing users.
- Only the settings in the network.ini-dist file can be set as default parameters.


top of the page

15. Development languages

Development languages (.lng) are rewritable files, which fill text to insert.
Data are organized in a tree with two levels.

Remark: Hints of items are in French only. See 'Help Context' parameter to deactivate it.
top of the page

16. Shortcuts

In menu:

File
Ctrl+O Open Open file
Ctrl+S Save Save modifications
Shift+Ctrl+S Save all Save all modified files
Ctrl+F4 Close Close current document
Shift+Ctrl+F4 Close all Close all documents
Alt+F4 Quit Quit HAPedit
Edit
Ctrl+Z Undo Undo last modification
Shift+Ctrl+Z Redo Revert last undo
Ctrl+X Cut Cut selected text
Ctrl+C Copy Copy selected text
Ctrl+V Paste Paste text from clipboard
Shift+Ctrl+V Special Paste Apply special filter to clipboard text (Configure the filter by selecting Ctrl+D => Filter/Paste).
Ctrl+A Select all Select all text
Ctrl+E Edit tag Edit html tag under cursor
Shift+Ctrl+E Select tag Select tag from <tag> to </tag>
Search
Ctrl+F Find Search for string in document, all open documents or in multiple project files
Ctrl+F3 Find Selected Search for next occurence of selected text
F3 Find Next Find next of last string search for
Ctrl+R Replace... Replace text in document(s) or in project files
Ctrl+G Goto line... Move cursor to specified line
Actions
Ctrl+Q Query String Associate Query String with current document for http requests
Alt+F12 SQL Console... Display SQL console for executing requests
Shift+F2 "Compiled" code Display "compiled" code of current document
Ctrl+F2 HTML Validator Display html parsed code of current document
Ctrl+F9 Compile code Compile dynamic page code
Actions -> Image
Ctrl+I Insert image... Select image to insert
Ctrl+Enter Preview image... Preview image under cursor
Actions -> Link
Ctrl+L Create link Create link (<a href="">)
Shift+Ctrl+L Create anchor Create anchor (<a name="">)
Ctrl+Enter Open link under cursor Open link under cursor (local file)
Actions -> Text
Ctrl+Alt+F (a) Font Insert tag <font>
Ctrl+Alt+P (a) Paragraph Paragraph <p>
Ctrl+Alt+B (a) Block quote Insert block quote <blockquote>
Ctrl+Alt+D (a) Align text Align selected text with tag <div>
Shift+Ctrl+G Bold Set selected text in bold
Shift+Ctrl+I Italic Set selected text in italic
Shift+Ctrl+U Underline Set selected text underlined
Shift+Ctrl+F Apply filter Apply user filter to selected text (Configure the filter by selecting Ctrl+D => Filter/Paste)
Shift+Ctrl+M Convert to lowercase Convert selected text to lowercase
Ctrl+Alt+M (a) Convert to uppercase Convert selected text to uppercase
Shift+Ctrl+S Convert spaces Convert spaces to  
Shift+Ctrl+P Convert to asp or php Replace " character in selected text with \" (PHP) or "" (ASP)
Ctrl+H Insert Html string... Insert string and convert special chars to HTML entities
Shift+Ctrl+H Convert to HTML Convert special chars to HTML entities in selected text
Actions -> Special
Ctrl+P Add list items... Define list style to insert
Ctrl+B Insert tag... Insert tag or enclose selected text within specified tag
Shift+Ctrl+B Insert tag ASP or PHP Insert <% %> or <? ?>
Ctrl+N Add invisible char Add non-breaking space
Ctrl+M Add carriage return Add tag <br>
Shift+Ctrl+C Insert comment Insert Html comment
Ctrl+Alt+C (a) Add HTML color Add numeric HTML color from color palette
Project
Ctrl+Alt+O (a) Open... Open project files
Ctrl+F10 Projects list Display projects list
Shift+F10Folder FileOpen project explorer handling folder of current file
Display -> Views
F2 Documents Switch to panel "Documents" to edit some code
F6 Images Switch to panel "Images" to explore code images
F7 Links Switch to panel "Links" to explore code links
F8 Properties Switch to panel "Properties"
F9 Page Launch default browser to view the page
F10 Folders Switch to panel "Folders" to manage internal folders
F11 Information Switch to panel "Information"
Display
F12 Organize... Organize opened documents
Ctrl+F11 Clip Library Display or mask a dockable windows with useful clips
Ctrl+D Languages Select from complete drop-down lists of native functions, methods and properties in ASP, PHP, VBScript, ADOB, CSS-1 to insert in document at the cursor.
F5 Refresh Refresh active panel view
Ctrl+KShow blocksHighlight dynamic code blocks
Maj+Ctrl+KBrace-MatchingHighlight brace block '{}', '()' or '[]'
Help
F1 Summary Help summary
Shift+F1 Index Help index
Ctrl+F1 Contextual Help Html or php help for current tag or function

In editor:

Code
Ctrl+J Show Code Template (drop-down list of macros)
Ctrl+Space Show Code Completion drop-down.
Shift+Ctrl+Space Show Code Hint (syntax help for PHP function parameters)
Move
Ctrl+Right One word to the right
Ctrl+Left One word to the left
Ctrl+PgUp Top of screen
Ctrl+PgDn Bottom of screen
Alt+Right Next document
Alt+Left Previous document
Alt+Up Beginning of current code block: '()', '{}' ou '[]'
Alt+Down End of current code block: '()', '{}' ou '[]'
Delete
Ctrl+T Delete word to the right of cursor
Ctrl+BkSp Delete word to the left of cursor
Ctrl+Y Delete current line (entire line).
Shift+Ctrl+Y Delete to end of line (from cursor right).
Ctrl+Del Delete text within 2 HTML tags.
Shift+Ctrl+Del Delete the both HTML tags (open/close) around the text.
Misc
Escape Cancel selection / Close Code Completion
F4 Toggle text selection mode (Normal/Column/Line)
From Shift+Ctrl+0
to Shift+Ctrl+9
Place Bookmark
From Ctrl+0
to Ctrl+9
Go to Bookmark

Note :
(a) Extended shortcuts: can be deactivated in general Options.


Realised with Tom L.'s help.
top of the page

17. User filter

User filter is not used very much, but it can be highly useful in certain cases.

First of all, user filter is found on the 'User data' window (Ctrl+D).

If you know C function 'printf' or Pascal 'format', then filter is the argument and the text (see below) is the parameter.
If you don't know function 'printf', then here's how it works:
"printf('<strong>%s</strong>', 'so free')" gives "<strong>so free</strong>"

So, in the 'User data' filter, you provide a string (eg: "<strong>%s</strong>"). In editor there is two ways to apply it:
- Shift+Ctrl+V to give the Windows clipboard text as a parameter,
- Shift+Ctrl+F to give selected text as parameter.

Of course, "<strong>%s</strong>" is basic sample, but "</tr><td>%s</td><tr>" will be more useful.
Now, it's up to you, to discover all the possibilities.


top of the page

18. Templates

Template documents are used each time you create a new document.
The number of templates that you can use is unlimited!
If you create a new document without an import template, HAPedit will use the template document 'default'.

To create a template:
In menu: File | Save as template
 
To import a template:
In menu: File | New | Import template
In templates files, some terms will be replaced after loading file: - For dates/hours "dddd" represents the day of week,
   "dd" the day of month, "mm" the month, "yyyy" the year,
   "hh" hours, "mm" minutes, "ss" secondes.
- Some samples are shipped with file to download.
 

top of the page

19. Known problems

Known problems are:


top of the page

20. Terms of use

free, so free...

This program is freeware, it CAN'T BE SOLD OR EXCHANGED. Each copy, duplication, distribution, transfert on network, phone line or other electronic support, for private or collective usage, is HIGHLY recommended.

If you use HAPedit to build sites, then you can add one of my logos to your pages.

You can also add a link from your sites to HAPedit.


top of the page

21. Miscellaneous


top of the page

May 2004       top of the page