David King (Wednesday, 24. November 2010)
> It appears that xsltproc is already installed in my Ubuntu. So, I
> now want to generate the English html files for myself to make
> sure I can - what do I type on the command line?
There are two ways to work/start:
1) The standard way is using autotools (automake, autoconf, etc.); you
should start with
$ ./autogen.sh ALL_LINGUAS=en
which does some checks and runs automake, autoconf and configure.
If everything is ok you will then have a Makefile and can do
everything using the "make" command, e.g.
$ make help
$ make html-en
$ make html # only if you cofigured with 'ALL_LINGUAS=en'
# otherwise all html's are built
$ make validate-en # is it still valid DocBook?
2) IMHO the autotools are a) bloated and b) overkill for our project,
so I created a Makefile that should "just work"; all you have to do is
to type
$ make -f Makefile.GNU ... LINGUAS=en
or
$ make -f Makefile.GNU ... # for targets ending with '-en'
instead of "make ...".
If some required program is not installed, this "make" will just
fail...
If you add "VERBOSE=2" to your 'make' command you will see which
commands are executed by 'make'.
> Then, if that works, I *think* I need to create a branch so that I
> can safely work on the re-structure. What do I type on the command
> line?
Most important command:
$ git help branch
Creating a new branch is not really necessary, but it's a clean way,
especially for major changes, and it's cheap (and easy):
$ git branch name_of_your_new_branch
You'll have to checkout ("git help checkout") that new brach, that is
to "change to this new branch":
$ git checkout name_of_your_new_branch
You can also combine both steps:
$ git checkout -b name_of_your_new_branch
> By the way, did it occur to anyone that having a help system that
> needs a programmer to change it rather limits the people who will
> help to... programmers - whereas what you really need to write
> help is authors ;). There's a huge barrier - still in front of me
> - before I can even begin to edit. I don't need to understand the
> inner workings - sure with enough effort I could, but what a waste
> of my time!
We used to have an INSTALL file, but it seems that it's gone. :-(
Bye
Ulf
PS: Do you see the contradiction:
> Ah, right, I can give you some examples... ;) [...]
vs.
> ... having a help system that needs a programmer ...
;-)
--
Beten heißt den Himmel melken wollen.
-- Karlheinz Deschner
Attachment:
signature.asc
Description: This is a digitally signed message part.
_______________________________________________ Gimp-docs mailing list Gimp-docs@xxxxxxxxxxxxxxxxxxxxxx https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
