Menu
▾
▴
generguide-devel — Discussion for developers of generguide
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
(33) |
Jul
(21) |
Aug
(20) |
Sep
(80) |
Oct
(62) |
Nov
(8) |
Dec
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2004 |
Jan
|
Feb
|
Mar
|
Apr
|
May
(1) |
Jun
(4) |
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
(2) |
| 2006 |
Jan
|
Feb
|
Mar
(1) |
Apr
|
May
|
Jun
|
Jul
(3) |
Aug
(6) |
Sep
(1) |
Oct
(6) |
Nov
(7) |
Dec
(12) |
| 2007 |
Jan
(9) |
Feb
(12) |
Mar
(1) |
Apr
(4) |
May
(6) |
Jun
(11) |
Jul
(16) |
Aug
(19) |
Sep
|
Oct
|
Nov
|
Dec
|
|
From: Cameron S. <ca...@sh...> - 2003-10-31 21:17:40
|
I've packaged up generguide 0.2rc1 for internal review. You can download it at: http://generguide.sf.net/downoads Please forward any comments though. I hope to release 0.2 Sunday night my time, Sunday morning for Artur and Sean. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-28 12:39:37
|
--- Artur Hefczyc <ko...@pl...> wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Cameron Shorter <ca...@sh...> writes: > > generguide/docs/oper and have put Seans docs in > there. (Still missing a > > couple of dirs, not sure if they are in the right > place) > Did you check it in other projects? I mean apache > projects have well > designed and well tested directories hierarchy. > Maybe we could take > sample structure from their projects? Each project defines its own. The problem is that there is a difference between generguide and other projects. Generguide is mostly about documents. Other projects are mostly about the code. The requirements for folder structure is different. In code projects the documents are normally kept with the code. We can do this, but I don't think it will scale when we get to the repository concept. The folder structure I have suggested is based on my own organisation. The idea is to categorize information, hence the high-level (depth 1) names. An information category can hold many documents. Whether you place then in one folder (depth 1) or create seperate folders for each sub-type (depth 2) depends on how many documents you perceive will be collected under depth 1. I normally create a folder per document. This is especially useful when working with modular concepts as it keeps the files of a book together. I know that the files in this folder A are the main resources for this book. I can therefore checkout just that list of files and not have to dig around a list of 100 files when I only need 10. The same applies to images. The folder structure should be like a library system found in a bookstore. So if you want non-fiction, ingnore the fiction. If you want DIY books, ignore the Health and Beauty section etc. Except for very special parts of information, you will find that there is very little content reuse between books of different categories and sub-types. However, in the case were a set of books is related, such as the subject of generguide, there may be a greater degree of reuse. Though the level of reuse is likely to manifest itself as Xpointer to a section within an article. Hence the structured authoring requirements. Something that has not yet been engineered into the USer Manual. It is part of the embelishment I want to do to the documents. For an idea of information classes that are part of product development, see the attached UML (poseidon). There is the beginnings of a class diagram that expresses the information groups as classes and the sub-types as operations. Sketching in this way may help you to make a decision. Sean Wheller __________________________________ Do you Yahoo!? Exclusive Video Premiere - Britney Spears http://launch.yahoo.com/promos/britneyspears/ |
|
From: Artur H. <ko...@pl...> - 2003-10-28 11:32:14
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Cameron Shorter <ca...@sh...> writes: > generguide/docs/oper and have put Seans docs in there. (Still missing a > couple of dirs, not sure if they are in the right place) Did you check it in other projects? I mean apache projects have well designed and well tested directories hierarchy. Maybe we could take sample structure from their projects? Artur - -- Artur Hefczyc Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/> iD8DBQE/nlHL0/6x1bjSKPkRAqFSAJ9bAyyiMAIJzc+T05RogB/c+D3HwQCgmiJ7 t7uP8O3CVjUoAAhzzWTi2S8= =JasI -----END PGP SIGNATURE----- |
|
From: Sean W. <se...@ya...> - 2003-10-28 11:18:51
|
--- Cameron Shorter <ca...@sh...> wrote: > I've setup > generguide/docs/oper and have put Seans docs in > there. (Still missing a > couple of dirs, not sure if they are in the right > place) > > generguide/docs/desc and have put my docs in there. OK. I was thinking to sperate the descriptive materials from the User Manual so we will have a GenerGuide Description document. The requirements will be under enge I was going to seperate that part out of the generguide.xml (your doc) > > -- > Also I've written a script > generguide/bin/comment_ent.sh which swaps > <!--&var;--> and &var; > Ie, comments out entities so that you can edit it > with XXE. OK p.s. I am at the office now, but I am behind a firewall. All ports for IRC etc are closed so I cannot join you know. Sean Wheller __________________________________ Do you Yahoo!? Exclusive Video Premiere - Britney Spears http://launch.yahoo.com/promos/britneyspears/ |
|
From: Cameron S. <ca...@sh...> - 2003-10-28 11:02:16
|
I've setup generguide/docs/oper and have put Seans docs in there. (Still missing a couple of dirs, not sure if they are in the right place) generguide/docs/desc and have put my docs in there. -- Also I've written a script generguide/bin/comment_ent.sh which swaps <!--&var;--> and &var; Ie, comments out entities so that you can edit it with XXE. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-27 12:01:33
|
--- Cameron Shorter <ca...@sh...> wrote: > On Sunday 26 Oct 2003 10:35 pm, Cameron Shorter > wrote: > > > Technically it should be in docs. But I don't > think > > > that the docs folder should hold sdocbook. > Rather > > > create a structure like: > > > /doc/manual > > > /doc/requirements > > > etc. > > > > Sean, > More questions about the docs directory before I > create it. (Directories are > hard to remove from CVS if you change your mind). > > I agree we should remove docs/sdocbook > Should we have: > docs/homepage/*xml : web home page of generguide, > currently my docs > docs/user/*xml : user guide files > > Or should we keep the directories flat and have: > docs/*xml Attached is a recommendation. Open in any text editor. This recommendation is mmodeledalong the concepts: * inherent to the practice of Modular Docbook * mechanics of the GenerGuide application It also serves as a recommendation for implementation of generguide repository in the Generic Sense. Sean Wheller __________________________________ Do you Yahoo!? Exclusive Video Premiere - Britney Spears http://launch.yahoo.com/promos/britneyspears/ |
|
From: Cameron S. <ca...@sh...> - 2003-10-27 11:29:56
|
On Sunday 26 Oct 2003 10:35 pm, Cameron Shorter wrote: > > Technically it should be in docs. But I don't think > > that the docs folder should hold sdocbook. Rather > > create a structure like: > > /doc/manual > > /doc/requirements > > etc. > Sean, More questions about the docs directory before I create it. (Directories are hard to remove from CVS if you change your mind). I agree we should remove docs/sdocbook Should we have: docs/homepage/*xml : web home page of generguide, currently my docs docs/user/*xml : user guide files Or should we keep the directories flat and have: docs/*xml -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-27 08:02:39
|
Obtaining a Working Copy: The prefered download will be to download a zip file. This will be available from: http://sourceforge.net/projects/generguide/ I've put version 0.1 there, 0.2 will be there as soon as we have finished the docs. -- I don't think that downloading source via CVSView should be recommended by the guide. It is a very messy way to download the project. -- Package Folders: docbook-xsl/ directory has been deprecated. We now import the directory into lib/docbook-xsl/ using bin/install-libs.sh . -- Local Installation: Step 4: install-libs.sh is not required as we will package up the libs in the prepackaged .zip file. Let's keep installation as easy as possible. -- Making Generic Documents: You note that the root element of a document may be any sdocbook element. This should be the case, however we have taken short cuts in the XSLT and have only supported "section" and "article" elememts as the root element. -- External Entities: It is worth noting that we are considering alternatives to replace our use of Entities. -- Markup Practices & Structure: Both have included "Section Structure" -- Configuration: generguide/baseurl is not used. -- Generguide Reference/Entity Reference Development: I think we should remove this section. Entities will be different for each project and we should point at the entity.ent file for people to reference instead. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-26 20:58:10
|
There is a lot of content in the Users Guide which duplicates content I've already put together. I think we need to determine what content goes into which document. Apart from a couple of common sections, I assume we don't want to have the same content in multiple web pages, and we certainly don't want the same content in different source docs as it creates a maintainence problem. -- Abstract: I think you can probably draw some text from my "Abstract". -- System Overview: I'd imagine that this section could almost include a lot of text from my "About" section. I'd add to my "About" -- Figure 2: High-Level Architecture: This diagram doesn't describe the architecture. I suggest that you don't need a diagram to explain the architecture, your text is enough. I'd keep your Introduction/System Overview/Generguide. (nice break down of concepts). However I think it doesn't describe "what is unique" about generguide. This is what I tried to address in my "About" section and "Abstract". -- I think you need to explain what the following list terms mean: Distributed Authoring Structured Authoring Context Reuse Single-Sourcing -- Command Line Processing Model/process steps: You have correctly documented the current code, however now we have a generconfig.xml we are going to remove the logic where local sections overwrite generguide sections. Ie, steps 1 and 2 have been removed. Step 3 processes the generconfig.xml to selectively include external sections. -- CGI processing model: I think this logic is too much detail for a users guide. It belows in a design guide. I assume a users guide should focus on how you drive the Web pages. -- Docbook I think you should mention that original docbook was not XML and that we only support XML versions of docbook. Ie, users will need to convert their docbook to docbook XML before we can process it. -- Micrsoft Word and others: I think that somewhere we need to acknowledge that the majority of business docs are currently written in Word format. We should have a policy on word docs. Should we support it? If not, why not. Is it possible to create a word template which maps to docbook tags? If so, can we then transform word docs to docbook? -- Got to go to work now. I will be online again morning and night (Sydney time). I often have my computer connected, but am running round the house making breakfast and the like. If you try and contact me via ICQ, my computer beeps and I should be able to hear it. So You might consider installing ICQ. Still reviewing ... -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-26 11:39:06
|
On Sunday 26 Oct 2003 10:09 pm, you wrote: > --- Cameron Shorter <ca...@sh...> wrote: > > On Monday 20 Oct 2003 7:14 am, Sean Wheller wrote: > > > > OK, I'll get back to you on this. > > I'm not sure what directory we should put this in. > > Technically it should be in docs. But I don't think > that the docs folder should hold sdocbook. Rather > create a structure like: > /doc/manual > /doc/requirements > etc. OK. Sounds good to me. > > > > There are some things I want to speak to you > > > > about, hope you can be online > > > > > tomorrow night (Sunday JHB). > > > > I am now. 7:45pm Sydney time (we have switched to > > daylight saving). > > I will be online for about another 2 hours. > > I will be on IRC again tomorrow morning at about > > 6:00am Sydney time. > > Are you there now? Otherwise schedule a time that is > good for you after 20H00 RSA JHB. I'll see how early I can get up. http://www.timeanddate.com/worldclock/meetingtime.html?p1=240&p2=262&p3=111 Probably more like 8:30 - 9pm. > > > I want to include your guide, but I'm having > > problems reading it. (It > > includes a number of refereces to "C:\dirname\..." > > Ie, your hard drive. > > I'm trying to convert the format now. > > Oh dear, I forgot to put the prolog back to standard. > You will have to replace the file paths to match your > system. Any text editor will do it. I have not edited the doc yet, so feel free to make any changes you like. |
|
From: Cameron S. <ca...@sh...> - 2003-10-26 09:05:30
|
On Monday 20 Oct 2003 7:14 am, Sean Wheller wrote: > Bet ya thought I would never share:-) I confess I had my doubts. Well done for getting it in. > > Well here it is. There are some things that still need doing, but I think > it is a good first draft. Ready for yourself and art to contribute. It > > I cannot commit to the CVS, so I will leave this up to you. Just let me > know where and then we can work out how we collaborate on the files. OK, I'll get back to you on this. I'm not sure what directory we should put this in. > > There are some things I want to speak to you about, hope you can be online > tomorrow night (Sunday JHB). I am now. 7:45pm Sydney time (we have switched to daylight saving). I will be online for about another 2 hours. I will be on IRC again tomorrow morning at about 6:00am Sydney time. I want to include your guide, but I'm having problems reading it. (It includes a number of refereces to "C:\dirname\..." Ie, your hard drive. I'm trying to convert the format now. I won't release generguide tonight as planned so that I have a chance to chat with you first. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-25 23:06:07
|
I'm very close to finishing the documentation and cleaning up the odds and ends. I reckon I will be finished by Sunday night (Sydney time). That would be Sunday morning 26 October for Artur and Sean. Sean, It would be great to have your Users Guide included, however I don't want to continually postpone release. I'm hoping a release will attract users and developers and may inspire WYSIWYM editor maintainers to support the Generguide modular framework. As mentioned before, if you are short of time I'm happy to take your draft and finish it off. Otherwise, I will just put together a very simple Users Guide. If you like, we could incorporate Sean's documentation post release (0.2.1 or 0.3), although that would not be as widely read by initial potential users. Based on this schedule, the deadline to get code into 0.2 is Saturday night for Sean and Artur, although earlier will be better. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-25 00:01:53
|
I've finished writing the docs. It would be good to get feedback if it is hard to understand. In particular, I'd like to know if the main page is clear and understandable. file:///home/cameron/work/generguide/docs/www/index.html -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-24 20:22:46
|
Discussion between Artur and Cameron. Mainly technical issues about release process. Will still try and meet Sean on IRC tomorrow to convince him to show us his docs. :) -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-22 20:01:08
|
Yes, I think I understand. We are doing something similar to importing external entities. Rather than import <section> nodes as I suspect you are doing, we import <section> nodes using <xinclude>. Using <xinclude> means that your source documentation remains valid XML which makes processing easier for your tools. The included nodes can come from remote locations and get imported during docbook XSLT processing. This is what the XML looks like: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE section PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" "http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd" [ <!ENTITY % xinclude PUBLIC "-//GenerGuide//ELEMENTS XInclude for SDocBook V1.0//EN" "http://generguide.sourceforge.net/xinclude/1.0/xinclude.mod"> %xinclude; ]> <section id="configurationmanagement"> <title>Configuration Management</title> <para>Software configuration management involves recording and retreiving all versions of software in a system.</para> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="http://somelocation.com/generguide/guide/cvs.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="versionnumbers.xml"/> </section> Is using <xinclude> instead of ENTITIES an option for you? We still use Entities for variable names, eg: &project_name; ,however we are considering alternatives for variable names due to the processing dificulties and hence poor support of ENTITIES. In particular there is poor support for ENTITIES from WYSIWYM editors. You may want to join the generguide-devel email list where we have been discussing these issues. Follow links from http://sourceforge.net/projects/generguide . On Thursday 23 Oct 2003 1:58 am, Saqib Ali wrote: > Hello Cameron, > > This looks like an interesting project, and I think it can help me in my > project. Here is what I need to do: > > Let us say there is a XML document at http://www.nowhere.com/doc.xml, > which references multiple external entities. > > Now I need to be able to able to d/l all the entities that the document > references, and place them on the local machine, with the same direcotry > structure that the master xml document uses. > > I do not want to import/include external entities in one document, instead > I want to download, and re-create the same directory structure. > > Let me know if my explanation was clear enough. I can give you more > details. > > Thanks. > Saqib Ali > --------- > http://validate.sourceforge.net <--- XHTML/HTML/DocBook Validator > > On Wed, 22 Oct 2003, Cameron Shorter wrote: > > Hi, > > You seem to be working on something similar to a project I'm working on: > > http://generguide.sf.net > > We are about a week away from our 0.2 release when we go public, but I > > thought you might want a sneak preview since you are working on similar > > stuff. In particular, check out: > > http://www.gisontheweb.com:8080/~cameron/cgi-bin/processconfig.pl > > (select the Build Documentation button). > > > > I'd be intersted to hear your thoughts on this project. > > > > On Wednesday 22 Oct 2003 1:13 am, Saqib Ali wrote: > > > Thomas, > > > > > > Thanks for testing the validator. The Validator is a for simple > > > documents, especially for people who are new to DocBook, and would like > > > to validate their documents on-line. > > > > > > You are getting the error, because you are refencing external entities > > > in your document, that the system doesn't know about. > > > One of the things I need to implement is to allow uploads of tar files, > > > which contain all the XML files (external entities as well). Hopefully > > > I should be done next week with this (Lord Willing). > > > > > > Thanks. > > > > > > Saqib Ali > > > --------- > > > http://validate.sourceforge.net <--- XHTML/HTML/DocBook Validator > > > > > > On Tue, 21 Oct 2003 tho...@24... wrote: > > > > Hello Ali, > > > > > > > > Thanks for your effort; I tried your validator and got a bunch of > > > > error-messages i do not understand. > > > > > > > > The most of them concern my extensiv usage of "<!ENTITY...". > > > > > > > > The source (and related documents) are available from > > > > http://www.thomas.miglinci.name/simpad/xml/simpad-howto.xml > > > > > > > > > > > > How can i handle those error-messages - besides: i can generate > > > > documents from this sources - see e.g. > > > > http://www.thomas.miglinci.name/simpad/simpad-howto.html > > > > or > > > > http://www.thomas.miglinci.name/simpad/simpad-howto.pdf > > > > > > > > Thomas > > > > > > > > > > > > -----Original Message----- > > > > From: "Saqib Ali" <sa...@se...> > > > > Sent: Tuesday, October 21, 2003 4:40 AM > > > > To: "di...@en..." <di...@en...>, > > > > "do...@en..." <do...@en...> Subject: Online DocBook > > > > XML Validator > > > > > > > > Hello All, > > > > > > > > This evening I plugged in the DocBook 4.1.2 /4.2 DTD to my webbased > > > > validator > > > > > > > > Here is the link to it : > > > > > > > > http://validate.sourceforge.net > > > > > > > > Give it a try. I need to make quite a few improvments. But let me > > > > know your thoughts. > > > > > > > > Try this document http://www.xml-dev.com/xml/apache.xml (there is one > > > > error in the document). > > > > > > > > Remember it only support 4.1.2 and 4.2 right now. Also the Doctype > > > > must be declared in the first 3 lines of the document: > > > > <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" > > > > "http://docbook.org/xml/4.2/docbookx.dtd"><!DOCTYPE article PUBLIC > > > > "-//OASIS//DTD DocBook XML V4.2//EN" > > > > "http://docbook.org/xml/4.2/docbookx.dtd"> > > > > > > > > The validator is powered by onsgmls > > > > > > > > Saqib Ali > > > > --------- > > > > http://validate.sourceforge.net <--- XHTML/HTML/DocBook Validator > > > > > > > > ______________________ > > > > http://lists.tldp.org/ > > > > > > ______________________ > > > http://lists.tldp.org/ > > > > -- > > Cameron Shorter http://cameron.shorter.net > > Open Source Developer http://generguide.sourceforge.net > > http://mapbuilder.sourceforge.net > > http://geotools.org > > Senior Software Engineer http://www.adi-limited.com -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-21 03:47:49
|
On Friday 17 Oct 2003 9:02 pm, Cameron Shorter wrote: > Note the new location for the generguide CGI form: > http://www.gisontheweb.com:8080/~cameron/cgi-bin/processconfig.pl > PS. I've just worked out the document publishing part of the CGI above is > not working at the above URL. (It works on my home computer). > Something for me to debug tomorrow. Fixed. Check it out and let me know what you think. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-20 07:38:24
|
I didn't know of any meeting. Anyway, I was far to busy working on the docs. Sean --- Cameron Shorter <ca...@sh...> wrote: > Are we supposed to be having an IRC meeting now? I > seem to have been the only > person who has turned up. > If you can't make it now, shall we try for tomorrow? > Sunday 21:30 in Warsaw/Johannesburg > Monday 05:30 in Sydney > > Server freenet.org > Channel #generguide > -- > Cameron Shorter > http://cameron.shorter.net > Open Source Developer > http://generguide.sourceforge.net > > http://mapbuilder.sourceforge.net > http://geotools.org > Senior Software Engineer > http://www.adi-limited.com > > > > > ------------------------------------------------------- > This SF.net email sponsored by: Enterprise Linux > Forum Conference & Expo > The Event For Linux Datacenter Solutions & > Strategies in The Enterprise > Linux in the Boardroom; in the Front Office; & in > the Server Room > http://www.enterpriselinuxforum.com > _______________________________________________ > generguide-devel mailing list > gen...@li... > https://lists.sourceforge.net/lists/listinfo/generguide-devel __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-18 19:39:21
|
Are we supposed to be having an IRC meeting now? I seem to have been the only person who has turned up. If you can't make it now, shall we try for tomorrow? Sunday 21:30 in Warsaw/Johannesburg Monday 05:30 in Sydney Server freenet.org Channel #generguide -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@us...> - 2003-10-18 16:51:39
|
Cameron Shorter <ca...@sh...> writes: > It would be good if we could start using generguide v0.2 in the geotools > project as the first visable user of generguide. > What do we need to do to get generguide working within the maven framework? I agree however I regret to say maven sdocbook is not yet enough for our needs. I know I had to complete it's sdocbook support. The worse I can't guarantee I any time-line for this, at least any short time-line, however I promise I try to do it as soon as possible. Artur -- Artur Hefczyc "Don't change people, just live with them." Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ |
|
From: Cameron S. <ca...@sh...> - 2003-10-18 08:02:00
|
Artur, It would be good if we could start using generguide v0.2 in the geotools project as the first visable user of generguide. What do we need to do to get generguide working within the maven framework? -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Sean W. <se...@ya...> - 2003-10-17 15:44:29
|
> Sean, I'm keen to help with the docs. I want to do some more work on it tonight and then I am sending you the files to commit or not. I have done most of the sections. Highly technical parts like generconfig.xml and the xsl's are not in. For the reason that they need to go into "The Developers Guide". Oops. Yes I forgot to mention. The "User Manual" is for Authors. As most will not understand XSL and would rather just use the CGI forms and the sh than understand how it actually does the processing, in what stages. I have concentrated on the Authoring perspective. I think this separation will be good as it will not scare away potential non-technical Technical Authors. Excuse the pun. Sean Wheller __________________________________ Do you Yahoo!? The New Yahoo! Shopping - with improved product search http://shopping.yahoo.com |
|
From: Cameron S. <ca...@sh...> - 2003-10-17 11:06:11
|
Note the new location for the generguide CGI form: http://www.gisontheweb.com:8080/~cameron/cgi-bin/processconfig.pl I've updated XSL processing so now you can specify an external reference to get your section from. Ie: <generconfig> <nodeset filter="BLACK"> <node id="identification" filter="DEFAULT"/> <node id="systemoverview" filter="BLACK" href="http://generguide.sourceforge.net/guide/systemoverview2.xml"/> </nodeset> </generguide> This now means that you can build a software developer's guide by: 1. Write your own customised sections and put them on the web somewhere. 2. Build a generconfig which references Generguide's Software Developer's guide for most sections, and your web site for your customised sections. 3. Use generguide to build your customised docs!! I think that completes all the functionality required for release 0.2. Sean, I'm keen to help with the docs. PS. I've just worked out the document publishing part of the CGI above is not working at the above URL. (It works on my home computer). Something for me to debug tomorrow. -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-10-14 20:36:04
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi, I just submitted changed install-libs.sh script which now installs all required libraries. You don't need to remove existing lib/ directory. It will add missing file to this location. Try it again I hope to works for you now. The best test is: generpublish.sh -j -F pdf,html,xhtml To have better PDF output we can create appropriate param_pdf.xsl file to setup some things - future improvement. Artur - -- Artur Hefczyc "Don't change people, just live with them." Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/jF4P0/6x1bjSKPkRAhF3AKCY6Nk8Ko6a1A9+lP0hhnXG5B/KGgCeLSPR 0eV3zczbKhthhXfdOMRcLsA= =5KsM -----END PGP SIGNATURE----- |
|
From: Cameron S. <ca...@sh...> - 2003-10-14 19:43:06
|
On Tuesday 14 Oct 2003 11:13 pm, Artur Hefczyc wrote: > I have just committed files with new functionality implemented > (finished): Excellent!!! The following were tested and work: generguide -F xxx generguide The following have me problems: 1064 cameron@gi> bin/generpublish.sh -j cp: omitting directory `bin/../guide/CVS' cp: omitting directory `bin/../guide/images' cp: omitting directory `bin/../guide/resources' Error on line 11 column 2 of file:/home/cameron/work/generguide/tmp_9074/developersguide.xml: Error reported by XML parser: Cannot read from http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd (Server returned HTTP response code: 504 for URL: http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd) Transformation failed: Run-time errors were reported mv: cannot stat `tmp_9074/tmp_9074': No such file or directory ^C -- Cameron Shorter http://cameron.shorter.net Open Source Developer http://generguide.sourceforge.net http://mapbuilder.sourceforge.net http://geotools.org Senior Software Engineer http://www.adi-limited.com |
|
From: Artur H. <ko...@pl...> - 2003-10-14 18:51:16
|
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 I found project which might be interesting for our needs in the future. I have no time at the moment to look in details but I don't want to lose this project, so I am sending URL to mailing list: https://sourceforge.net/projects/openjade/ Artur - -- Artur Hefczyc "Don't change people, just live with them." Open Source Developer: http://www.geotools.org/ http://generguide.sourceforge.net/ http://wttools.sourceforge.net/ http://maven-plugins.sourceforge.net/ -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (GNU/Linux) iD8DBQE/jEWB0/6x1bjSKPkRAntbAJ9DlhIQPEZGr+GCQwS5EgZEbllIqwCgniX4 OeYuhXCbZt3aPiaqI+AysQ0= =gPAz -----END PGP SIGNATURE----- |
54 messages has been excluded from this view by a project administrator.
