← Back to team overview

kicad-developers team mailing list archive

Re: Fwd: Documentation update

 

I'm nearly ready for a pull request. I've just committed changes to my
repo so that PDF and HTML can be built on Windows and Linux.

Both dblatex and FOP are supported for PDF generation on Linux and
Windows, however I cannot get the dblatex PDF build to complete on
Windows because of a problem with the xlstproc I'm using. Perhaps
someone will have better luck than me. Because of that, I've noted in
cmake-readme.adoc in my repo that only FOP is suppored under Windows.

CMake just does feature checking, not platform checking, so you can
give anything that's supported a go. Getting the full dblatex tool
chain seutp on Windows is a bit of a pain!

Best Regards,

Brian.

On 14 April 2015 at 00:52, Nick Østergaard <oe.nick@xxxxxxxxx> wrote:
> Great.
>
> Den 13/04/2015 22.57 skrev "Brian Sidebotham" <brian.sidebotham@xxxxxxxxx>:
>>
>> I sync'd with Marco's repo so that's now reflected in my repo.
>>
>> I just need to do the po update stuff I think and then I'll do a pull
>> request to get the repo's aligned.
>>
>> Best Regards,
>>
>> Brian.
>>
>> On 12 April 2015 at 23:12, Nick Østergaard <oe.nick@xxxxxxxxx> wrote:
>> > I have now done this.
>> >
>> > 2015-04-11 13:48 GMT+02:00 Nick Østergaard <oe.nick@xxxxxxxxx>:
>> >> So now is a good time to remove the src/markdown and src/rest and move
>> >> src/asciidoc to src?
>> >>
>> >> If so, I can do that now, such that you can pull those changes.
>> >>
>> >> 2015-04-11 13:43 GMT+02:00 Brian Sidebotham
>> >> <brian.sidebotham@xxxxxxxxx>:
>> >>> On 11 April 2015 at 12:32, Brian Sidebotham
>> >>> <brian.sidebotham@xxxxxxxxx> wrote:
>> >>>> On 11 April 2015 at 12:11, Nick Østergaard <oe.nick@xxxxxxxxx> wrote:
>> >>>>> Great. I just looked briefly on the cmake setup. It seems to me like
>> >>>>> you intend to include a CMakeLists.txt inside each doc dir with the
>> >>>>> only change being the name or path of the root adoc file. Would it
>> >>>>> not
>> >>>>> mere more sense to have a common CMakeLists.txt in the src/asciidoc
>> >>>>> dir (to be renamed just src when we remove the markdown and rest
>> >>>>> variants), which searches the folders or is just given an array of
>> >>>>> root doc files?
>> >>>>>
>> >>>>
>> >>>> Things will change, I've just begun the start of adding macros to
>> >>>> create pdf and html targets. There's plenty more work to do yet.
>> >>>> Certainly there'll be a lot of common code that can be shared through
>> >>>> higher level cmake files.
>> >>>>
>> >>>
>> >>> The initial plan was to get CvPcb translation and generation complete.
>> >>> Once the repo achieves that, I can pull request it into Marco's repo
>> >>> and then hopefully there'll be plenty of resource to complete the
>> >>> CMake stuff, then Marco's repo will come under the KiCad umbrella.
>> >>>
>> >>> Best Regards,
>> >>>
>> >>> Brian.


Follow ups

References