kicad-developers team mailing list archive

[Wayne Stambaugh <stambaughw@xxxxxxxxx>]

Mario,

How did you generate the PDF files?  If you used LibreOffice or
OpenOffice, there are tools to convert ODT directly to asciidoc.  This
is how we created the initial asciidoc kicad documentation.  I believe
there are instructions in the doc repo about how to do this.  If not,
one of our doc devs should be able to help you out.  If you used some
other format to generate your pdf files, then you may be out of luck.

Wayne

On 2/11/2016 11:54 AM, Mário Luzeiro wrote:
> Hi Clemens,
> 
> I agree.. but
> I would need to rewrite it all to make it in a format that fits the documentation format of kicad. (and I am not much available at moment for that :/)
> Also, I think this is a bit "advanced" (user advance) in relation of the documentation that is missing(?) related with 3d-viewer. ..Things that are more basic for the user (I am not sure how much related with 3d-viewer is already on documentation... )
> 
> So if you get a good structure for documentation (in the .. "documentation structure") related with 3d-viewer I will think on a special version that would easily fits the documentation format (.adoc)
> 
> Mario
> 
> ________________________________________
> From: Kicad-developers [kicad-developers-bounces+mrluzeiro=ua.pt@xxxxxxxxxxxxxxxxxxx] on behalf of Clemens Koller [cko@xxxxxxxxx]
> Sent: 11 February 2016 16:39
> To: kicad-developers@xxxxxxxxxxxxxxxxxxx
> Subject: Re: [Kicad-developers] Tutorial and guidelines for better materials on 3D models
> 
> Hello, Mario!
> 
> Thanks for considering... :)
> 
> IMHO it would be just a pity linking to tons of different bits
> and pieces of documentation and tutorials in the web instead of
> pointing to a dedicated chapter in the (one) official Kicad
> documentation which could be updated, version tracked and
> delivered with the installation...
> 
> Clemens
> 
> On 2016-02-11 17:05, Mário Luzeiro wrote:
>> I agree that at this moment it better it better fits on the list of tutorials on the kicad website. I will be happy with that.
>> I am not familiar with the KiCad documentation, I had a quick look on the github and I think until there is a specific folder?/document for 3d viewer this documents does not fit very well there...
>>
>> Mario Luzeiro
>>
>> ________________________________________
>> From: Kicad-developers [kicad-developers-bounces+mrluzeiro=ua.pt@xxxxxxxxxxxxxxxxxxx] on behalf of Wayne Stambaugh [stambaughw@xxxxxxxxx]
>> Sent: 11 February 2016 15:48
>> To: kicad-developers@xxxxxxxxxxxxxxxxxxx
>> Subject: Re: [Kicad-developers] Tutorial and guidelines for better materials on 3D models
>>
>> If we are going to add information like this to our documentation, we
>> should create a separate document for the 3D viewer.  Given that
>> Cirilo's work will significantly change the scope of the 3D viewer, it
>> would probably be a good idea to have a separate document.  We can just
>> link to that document in Pcbnew and CvPcb.  If we decide to add this to
>> any of our documentation, would one of our native English speaking devs
>> please clean up the grammar.
>>
>> The other option is to add it to the list of tutorials on the KiCad
>> website.  I'm OK either way.
>>
>> On 2/11/2016 9:27 AM, Clemens Koller wrote:
>>> Hello, Mario!
>>>
>>> Looks good!
>>>
>>> Do you think it makes sense to reformat and merge the information
>>> for https://github.com/KiCad/kicad-doc ?
>>>
>>> Clemens
>>>
>>> On 2016-02-10 20:55, Mário Luzeiro wrote:
>>>> Hello all,
>>>>
>>>> It is known that most of VRML 3D model files used by KiCad users have bad material properties.
>>>> They are the 3D VRML files from KiCad library it self, other author libraries and online database libraries (from automatic conversion?). Also, some CAD softwares (eg: FreeCad) do not make good material assignment or convertion.
>>>>
>>>> In order to raise awareness, hoping that user will get one day better proper materials in their models, I created two tutorials that works as a reference and guide to understand and how to set proper materials to 3D models.
>>>>
>>>> The main scope are electronic components, VRML files, KiCad 3D-Viewer (current or any future version)
>>>>
>>>> It would be nice if you could share it in the KiCad webpage (tutorials?).
>>>> I've placed the documents in my cloud (you can use as a permanent link) but I can change it to other place (I plan to keep the documents update with new information):
>>>>
>>>> https://meocloud.pt/link/5b4a47ed-1fab-4133-8d50-52824d8a291f/KiCad_3D-Viewer_Illumination_model_and_materials-MarioLuzeiro.pdf/
>>>>
>>>> https://meocloud.pt/link/64e39e99-c5b6-451b-accd-9e25331ceafe/KiCad_3D-Viewer_component-materials-reference-list_MarioLuzeiro.pdf/
>>>>
>>>> I already discussed with some of most know 3D files authors related with KiCad and shared this work with them.
>>>> I hope you can share it with anyone interested. I was also thinking if it would be good to share with KiCad library team so they will better understand the problem of the 3D VRML files that KiCad is distributing at this moment. (Anyone can FW this email please? Thanks!)
>>>>
>>>> Regards,
>>>> Mario Luzeiro
>>>> _______________________________________________
>>>> Mailing list: https://launchpad.net/~kicad-developers
>>>> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
>>>> Unsubscribe : https://launchpad.net/~kicad-developers
>>>> More help   : https://help.launchpad.net/ListHelp
>>>>
>>>
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~kicad-developers
>>> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
>>> Unsubscribe : https://launchpad.net/~kicad-developers
>>> More help   : https://help.launchpad.net/ListHelp
>>>
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~kicad-developers
>> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~kicad-developers
>> More help   : https://help.launchpad.net/ListHelp
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~kicad-developers
>> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~kicad-developers
>> More help   : https://help.launchpad.net/ListHelp
>>
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~kicad-developers
> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~kicad-developers
> Post to     : kicad-developers@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp
>