DOS prompt
alternate Tool Bars
alternate Tool Bars
alternate Footer Buttons.gif

Deep­en­ing - The main pro­gram Con­sole

The Fold­er and file types se­lec­tion

Folder selection

Choice of the Com­mand lines

Folders combo

1. The File List View

File List View

1.a File down­load­ing List View

You can also down­load your site, or any site for which you want to show up a hy­phen­a­tion demo; a copy will be set into a de­fault (cus­tom) fold­er on your drive, with the URI as the start ad­dress.
The pro­gress bar and sta­tus for each file is shown un­til com­plete (col­or­ed in this web page), there­af­ter eve­ry file will be tagged into the pro­gress col­umn if hy­phen­at­ed al­ready.
On down­load com­plet­ed, the list of the lo­cal files will be made di­rect­ly ac­ces­si­ble, auto-up­dat­ing the ref­er­ence path; any file of known type a­mong the de­fault ex­ten­sions list will be checked, so that you can click the List se­lected files only to ex­clude im­ag­es and oth­er files not to be ed­it­ed.
Down­load­ing a whole web site, the pri­ma­ry host ref­er­ences only will be fol­lowed, ac­cord­ing to the |Sub­Di­rec­tory| but­ton's check sta­tus; out­side links will be dis­carded, be­sides any file that you want to pre­vent down­load­ing by the com­mand line fil­ters.

 Download progress

2. Search String in files and Re­place

Find_ReplaceCommand lines
The ex­am­ple into the im­age al­lows by it­self to en­code the first bytes of any mail ad­dress of a whole site in a for­mat es­cap­ing cer­tain ro­bots; of course, the |<A HREF="| could be en­cod­ed even dis­cour­ag­ing the most stub­born, for not to say the ad­dress (these strings can be searched and found by the hy­phenator-Pro).
Note that all Find ­/ Re­place and oth­er di­a­logs with string in­put are ex­press­ly built with re­siz­a­ble win­dows (and text box­es) in length, to aid the user en­ter­ing long lines with­out any loss of the vis­u­al con­trol.

3. Search files by String

Select files by String content

4. Search String in files and List­ing

Strok­ing a key into the View List will reach and high­light the next file name with that in­i­tial (Up­per or low­er), while the |Find­FNames| but­ton to the foot­er o­pens a di­a­log that let us find into the List View file Names con­tain­ing a string (press Ctrl key for all Case match).
The se­lec­tion of files ac­cord­ing to their con­tent can be start­ed by the |Find text in files­/ Re­place| com­mand from the po­pup menu, that o­pens a Find ­/Re­place di­a­log: its op­tions let you be­gin search­ing Up, or Down from one checked file, or through the whole cur­rent file list, or be­tween the de­fault se­lec­tion, if any.
When the (|List­ing|) op­tion is en­a­bled, all the oc­cur­rences of eve­ry searched string will be list­ed into the Log's frame, pre­ceeded by the byte po­si­tion num­ber in the for­mat §123:string; high­light it and click Ctrl+J to ac­cess the file, with the car­et pos­i­tioned over the string that was se­lected into the list. This makes very easy to i­den­ti­fy and reach words to be up­dat­ed, wher­ev­er into a whole site (see im­age be­low). To get it en­dowed with the best per­for­mance, a fur­ther op­tion was pro­vid­ed that al­low the user to set how many pre­ced­ing and fol­low­ing words are to be dis­played to aid fo­cus­ing the lo­ca­tion of eve­ry string found; e.g §123:four words be­fore the string and four words af­ter. The cam­e­ra icon (fig. 2) in­tro­duces two spe­cial, mean­ing­ful HTML op­tions for the en­cod­ed words de­tec­tion, as de­scribed be­low, that can be joined as well.

Listing of Strings in files

If you are look­ing for the word " com­mon­ly", that may ex­ist into a doc­u­ment in the hy­phen­at­ed for­mat: "com-mon-ly", (or any, in­de­pend­ent­ly by the hy­phen­a­tion rule) with this op­tion it can be rec­og­nized, the file checked and, when the |List­ing| op­tion is en­a­bled, dis­played into the Log's frame as a point­er to its line into the doc­u­ment, where you can im­me­di­ate­ly Jump by the Ctrl-J com­mand.
The main Con­sole con­sist in four main ar­e­as:
  1. a head­er, with 4 flex­i­ble and re­siz­a­ble Tool Bars with com­bo and op­tion but­tons;
  2. a foot­er, with var­i­ous di­rect com­mand but­tons, in that the can per­form ac­tions on files and sites with­out o­pen­ing the Watch-Ed­i­tor;
  3. a left frame where files are list­ed, to be se­lected and han­dled in var­i­ous modes;
  4. a right side with two frames: the up­per, very slen­der but re­siz­a­ble, shows the ex­plored paths; the low­er is a Log ed­i­tor: many task are [op­tion­al­ly] re­port­ed there and this area is in­ter­ac­tive, there­fore it can be used, or its con­tent re­cy­cled, ei­ther in Plain text mode or for var­i­ous ed­it­ing pur­poses need­ing el­e­men­ta­ry Rich Edit func­tions: Bul­lets, text A­lign­ment as well as In­den­ta­tion, Font­/Col­or text change with style and weight, Un­der­line and Strike Through, that may be use­ful for notes on jobs done al­ready, but that you want to keep in sight, since the wel­come page can be cus­tom­ized to be re­loaded on star­tup.
The Files to work on.
Wheth­er re­ceiv­ing a line of pa­ram­e­ters from a pre­lim­i­nary com­mand, or some di­rect clicks from the user, the first task for the main pro­gram is to walk the se­lected di­rec­to­ry (with sub­di­rect­o­ries, if the op­tion .(1) is en­a­bled), load­ing all those file_names match­ing spec­i­fied types, grouped in a cus­tom list of ex­ten­sions.(2).
The File Search path
The Fold­er icon to the up­per-left cor­ner of the Con­sole.(3) o­pens a Di­a­log for the se­lec­tion of a Path. Two but­tons: |sub­Di­rec­tory| and |auto.Back­up| re­fer to the found files and their state will be as­so­ci­at­ed to the se­lected path, which will be sto­red for the it­er­a­tive use. Ctrl-click to open start­ing from the in­dexed sto­red path.
The |sub­Di­rec­tory| tells the pro­gram to search all files in the sub­di­rect­o­ries of the se­lected path.
The |auto.Back­up| cre­ates a back­up copy eve­ry first time a se­lected file is be­ing changed.

.. is sto­red to be re­used.
Since eve­ry new path is sto­red into the in­i­tial­ization file, un­til a (cus­tom) max. of 32 lines, the list of the used paths is made a­vail­a­ble from a com­bo box to the low­er right of the Fold­er icon .(4). A spe­cial pick al­lows to di­rect­ly list the di­rec­to­ry on change of the path-line, or add to the text box pat­terns with wild­cards plus file date fil­ters, both for files to choose and­/or to dis­card.

Note that this, like all the edit com­bo box­es, is ex­tend­i­ble to al­low read­ing and writ­ing into the most vis­i­ble length. To do that put the cur­sor over the emp­ty area to the right of the tool­bar .(1), hold the mouse but­ton and drag; or click to its left to max­i­mize to the win­dow.

The File List view and Sort.
All the files found, no mat­ter their or­i­gin, are gath­ered and made ac­ces­si­ble into the List­View frame, with the col­umns: Date, full File­Name, Size, Time and rel­a­tive Path (|subDirs| checked) or ab­so­lute (ex­ter­nal pro­ject load­ed or dragged); then main Fold­er, that is the root ad­dress of the pro­ject, is vis­i­ble in the up­per right frame.

From the View List frame, all files can be filtered (by In­i­tial or string) and se­lected and sort­ed in many modes: As­cend­ing­/De­scend­ing, right-aligned fType or Re­versed fname.ext, checked and high­light­ed a­part, in or­der to hy­phen­ate­/un-hy­phen­ate or quick­ly han­dle them in two pos­si­ble ways: di­rect­ly on disk, or into ta­bbed Rich Edit frames, pow­ered by ad­vanced tools. By one side, the se­lected files may be load­ed then all to­geth­er for to be watched and ed­it­ed and browsed and stud­ied as to the font ef­fects and ­/ or win­dow's size in var­i­ous modes (see the next page); on the oth­er hand that list of files, or a saved se­lec­tion of them, can be hy­phen­at­ed or un-hy­phen­at­ed with­out o­pen­ing the Ed­i­tor Win­dow: the two but­tons |Hy­phen­ate|, |Un-hy­phen| to the bot­tom of the Con­sole di­rect­ly run these tasks, al­ways on the ac­tive choice of files. You may browse any file too by the |Browse| but­ton, that works on the first checked file, or the high­light­ed one if this op­tion is switched (List View po­pup menu).

Down­load­ing a web site
As for any file search, fil­ters can gen­er­al­ly (4) se­lect into a lin­e­ar se­quence spe­cif­ic file types or pat­terns (i.e. wild­cards) sim­ply de­limited by a space, and ex­clude spe­cif­ic types or pat­terns de­limited by the "[" (square brack­et) char­ac­ter. When the |LogReport| but­ton is checked, parsed files - as well as oth­er ac­tions' re­sults - are re­port­ed into the Log frame (red=source ­/ blue= saved); a bul­let points out eve­ry de­tected link to out­er sites.

Download report

Pro­jects and List se­lec­tions.
The ma­nip­u­lation of se­lected groups of files is quite im­por­tant for the fast han­dling of a site or a pro­ject. For this rea­son the View List frame is en­dowed of a dou­ble cri­te­ri­on for the file se­lec­tion and a po­pup menu with many op­tions to han­dle them.
  1. At first, eve­ry row has its check­box: this check is 'fixed', and will ad­mit eve­ry di­rect op­er­a­tion on files; any checked-box list can be saved, to be load­ed lat­er.
  2. The se­cond se­lec­tion mode is set high­light­ing lines, to be nor­mal­ly used to watch files into the Ed­i­tor; the last load­ed files se­lec­tion is re­stored as de­fault on star­tup, so that the same files can be eas­i­ly ed­it­ed by one but­ton tou­ch.
No change in ei­ther modes af­fects the oth­er, so the spe­cial in­ter­ac­tion of this dou­ble fea­ture leads from a sim­ple to pow­er­ful pro­jects ma­nip­u­lation at a time: switch­ing be­tween modes, any se­lec­tion ei­ther by check­box or high­light, can be trans­formed and trans­ferred in many ways from one side to the oth­er, cop­y­ing, past­ing, add­ing, sub­tract­ing, mir­ror­ing and fi­nal­ly sav­ing and load­ing so that, when the star­tup com­pli­es with an al­ready set com­mand_line, this one can take an ex­clu­sive list of files to be auto-load­ed or checked. The more, like a cher­ry on the cake, each ac­tion on a type of ac­tive se­lec­tion (check ­/ high­light) can be done clip­ping (or fil­ter­ing] its range ac­cord­ing to the op­po­site se­lec­tion area, thus de­lim­iting or fil­ter­ing the ac­tions to be tak­en on the cur­rent list, thus pro­vid­ing the great­er flex­i­bil­i­ty in plan­ning var­i­ous tasks on large files col­lec­tions.

The pow­er­ful strings Search, List and Re­place.
Be­sides the nor­mal op­tions, en­a­bled by the di­a­log but­tons, strings may be gen­er­al­ly searched in doc­uments and re­placed with some very spe­cial add on:
  • any string can in­clude more than one par­a­graph, with their Line Feeds; if load­ed into the Find ­/ Re­place di­a­log from any high­light­ed text se­lec­tion, the CR LF will be han­dled by the pro­ce­dure; to en­ter into one sin­gle line by the key­board, the CR LF will be re­placed by the "­/@" sym­bol (or oth­er cus­tom­iz­a­ble).
  • any string can be de­fined with wild­cards by sin­gle char­ac­ters: this is an ex^^ple, that will match the word ex­am­ple, as well as the ^^am^^^ will do (details).
    Since these op­tions can be com­bined both to the Find and Re­place func­tions, with the choice of match­ing or pre­serv­ing the up­per ­/ low­er case, their ap­pli­ca­tion range wid­ens.
    One more aid: search for en­cod­ed words
    Due to our job, strings to be searched for up­dates could re­sult hy­phen­at­ed into a doc­u­ment, mak­ing very un­easy to find them out; it is pro­vid­ed then to i­den­ti­fy them as nor­mal, what­ev­er their syl­lab­i­ca­tion might be:
  • To the Find side, two spe­cial but­tons let any string be searched both in its nor­mal and hy­phen­at­ed for­mat, as well as in any HTML en­cod­ing char­ac­ter En­ti­ty for­mat. The 1st mode through the op­tion |only| can help to sep­a­rate |hy­phen­at­ed files|, and to search those, or all files (|also| op­tion) for a word, syl­lab­i­fied or not. The 2nd in­de­pend­ent­ly al­lows the search of a word ex­ist­ing both in plain for­mat and with HTML en­tities rep­re­sen­ta­tion; i.e. the Ger­man word "Gebäude" (Build­ing) can e­ven­ly be i­den­ti­fied in the Geb&auml;ude or Geb&#228;ude no­ta­tion.
Be­fore in­tro­duc­ing a fur­ther com­bi­na­tion, let's add that all files with­in the list may be searched and gath­ered ac­cord­ing to their con­tent; this fea­ture, that can take ad­van­tage from the op­tions a­bove, e­ven­ly ap­pli­es to the [glob­al] |Search ­/ Re­place| func­tion from the List View po­pup menu, as well as to the Find ­/ Re­place in­ter­nal di­a­log, as it can be di­rect­ly ex­e­cut­ed on disk or driv­en to be con­firmed (|Re­place This|) , or sim­ply watched step by step (|Re­place All.V.|) into the view-editor (details there).
Here­af­ter the best: the el­e­men­ta­ry cre­a­tion of a batch text file that con­tains:
  1. the string (ex­pres­sion1) to find out;
  2. the string (ex­pres­sion2) that will re­place the pre­vi­ous ex­pres­sion1, ac­cord­ing to all the op­tions modes a­bove;
  3. an emp­ty line, as a sep­a­ra­tor from the next pair of pa­ram­e­ters: yes, the stack can be as long as need­ed and eve­ry pair of strings will be pro­cessed as re­quired, for each file, if di­rect on disk, or for all the load­ed files, when called to be opened into the View ­/ Ed­i­tor.
To ad­dress to a batch file en­ter the pre­fix "FILE:" fol­lowed by the path­\file­name it­self, like in the fig­ure.

To aid re­cy­cling the pairs of the Find and Re­place strings it is pos­si­ble to save and load the stack of data from-to the com­bo list of the di­a­log: click its tool bar Icon and se­lect the com­mand in the po­pup menu.

     the Tutorial Menu

     the Main Menu



    [resize 800x600] Nov-20-2006