[Docutils-develop] RE: Unsafe processing for the input file

[<g.s...@gm...>]

Hello Pierre-Yves,

I have just committed a new release of DocFactory. It has a
"Preferences"-Menu where you can select the option "Backup files". This will force DocFactory
to store a copy of the previous version of a file as "[filename].bak"
whenever a file is saved.

Please note that DocFactory saves a file only in the following cases:

* The user selects "File -> Save" from the menubar (or presses the toolbar's
"Save"-button).

* The user has modified a file with DocFactory and selects "File -> Publish"
from the menubar (or presses the toolbar's "Publish file"-button or presses
F7). 

If a file has NOT been modified, it is NOT saved before publishing. 

A modified file has to be saved before publishing because otherwise the
output file would not contain your last modifications. To understand this you
have to know that DocFactory does not process the input file by itself.
DocFactory is a simple text editor with an interface to Docutils. The whole
publish-process is done by Docutils. When you press F7, DocFactory saves the file ---
if you have changed it ---, calls the "publish_file"-function of
"docutils.core" and the rest is done by Docutils: Docutils reads the input file and
writes the output file. All error messages of Docutils are redirected to
DocFactory's log-window. 

The approach of DocFactory is very similar to programming environments where
the programmer edits her/his source code, saves the changes, runs the
compiler on the source code ...  and finally gets an executable program.

With DocFactory you edit a reSructuredText-file, save the changes, run
Docutils' publisher on the file and finally get an output file (HTML, LaTeX or
whatever ...). 

Best regards,
Gunnar.

> Bonjour, Merci.
> 
> About
> 	backup procedure which creates a copy
> 	"[filename].bak"
> it is indeed a good option, but from an end user point of view, keeping
> the
> original file untouched, even for its name , would be better.
> If I may dare another question :
> What is actually Docfactory modifying on the input file ? Some
> parsing/cleaning ?
> If answer is 'nothing', then, why saving thee file for outputting process
> ?
> 
> Thanks
> 
> PY Delens

-- 
+++ GMX - Mail, Messaging & more  http://www.gmx.net +++
Bitte lächeln! Fotogalerie online mit GMX ohne eigene Homepage!