Re: SPDX and docbook documentation, how to do properly?
Am Mittwoch, 5. Januar 2022, 15:21:24 CET schrieb Luigi Toscano: > Harald Sitter ha scritto: > > On Wed, Jan 5, 2022 at 1:45 PM Friedrich W. H. Kossebau > > > > wrote: > >> Hi, > >> > >> the section "License Statements in Non-Source-Code Files" at > >> > >> https://community.kde.org/Guidelines_and_HOWTOs/ > >> > >> Licensing#License_Statements_in_Non-Source-Code_Files > >> currently does not hold an example how to add SPDX tags. And by a quick > >> look it seems not many docbook files in KDE repos currently have any > >> such info, so no pattern could be derived from the real world samples. > >> > >> Also unclear to me how to best integrate with the predefined docbook > >> tags, or if duplication is needed? > >> > >> Could we have some example given by those with insights? > > > > I know next to nothing about docbook, but generally speaking this > > should simply follow the XML approach I expect > > > > > > <...docbook entity stuff> > > > > > > As for the duplication: It is my understanding that we route all our > > docbooks through meinproc5, so presumably that could be a place where > > we find the SPDX tags and auto-inject them into the docbook DOM - i.e. > > my thinking is we turn SPDX into the canonical author information and > > then have meinproc inject the DOM nodes accordingly, on the fly. Not > > sure how feasible that is though. > > I have the feeling it's better to keep them separate and duplicate them. > Some entities are translatable and I'm not sure how to achive it in a > proper way. Better leave the SPDX headers in the comments at the top of the > for now. Thanks for the replies. Based on this I added some info to the wiki page, please check and improve where needed: https://community.kde.org/Guidelines_and_HOWTOs/Licensing#DocBook_Files_. 28.2A.docbook.29 Cheers Friedrich
Re: SPDX and docbook documentation, how to do properly?
Harald Sitter ha scritto: > On Wed, Jan 5, 2022 at 1:45 PM Friedrich W. H. Kossebau > wrote: >> >> Hi, >> >> the section "License Statements in Non-Source-Code Files" at >> https://community.kde.org/Guidelines_and_HOWTOs/ >> Licensing#License_Statements_in_Non-Source-Code_Files >> currently does not hold an example how to add SPDX tags. And by a quick look >> it seems not many docbook files in KDE repos currently have any such info, so >> no pattern could be derived from the real world samples. >> >> Also unclear to me how to best integrate with the predefined docbook tags, or >> if duplication is needed? >> >> Could we have some example given by those with insights? > > I know next to nothing about docbook, but generally speaking this > should simply follow the XML approach I expect > > > <...docbook entity stuff> > > > As for the duplication: It is my understanding that we route all our > docbooks through meinproc5, so presumably that could be a place where > we find the SPDX tags and auto-inject them into the docbook DOM - i.e. > my thinking is we turn SPDX into the canonical author information and > then have meinproc inject the DOM nodes accordingly, on the fly. Not > sure how feasible that is though. I have the feeling it's better to keep them separate and duplicate them. Some entities are translatable and I'm not sure how to achive it in a proper way. Better leave the SPDX headers in the comments at the top of the for now. -- Luigi
Re: SPDX and docbook documentation, how to do properly?
> how to add SPDX tags. Aren’t docbooks just XML files? The reuse tool would add them as XML comment. Approximately like this: $ reuse addheader --style xml --copyright ... index.docbook > predefined docbook tags, Do you think it is important to not duplicate authors in the license statement and in the section? I think just duplicating this makes it easier for the reuse tool.
Re: SPDX and docbook documentation, how to do properly?
On Wed, Jan 5, 2022 at 1:45 PM Friedrich W. H. Kossebau wrote: > > Hi, > > the section "License Statements in Non-Source-Code Files" at > https://community.kde.org/Guidelines_and_HOWTOs/ > Licensing#License_Statements_in_Non-Source-Code_Files > currently does not hold an example how to add SPDX tags. And by a quick look > it seems not many docbook files in KDE repos currently have any such info, so > no pattern could be derived from the real world samples. > > Also unclear to me how to best integrate with the predefined docbook tags, or > if duplication is needed? > > Could we have some example given by those with insights? I know next to nothing about docbook, but generally speaking this should simply follow the XML approach I expect <...docbook entity stuff> As for the duplication: It is my understanding that we route all our docbooks through meinproc5, so presumably that could be a place where we find the SPDX tags and auto-inject them into the docbook DOM - i.e. my thinking is we turn SPDX into the canonical author information and then have meinproc inject the DOM nodes accordingly, on the fly. Not sure how feasible that is though. HS
SPDX and docbook documentation, how to do properly?
Hi, the section "License Statements in Non-Source-Code Files" at https://community.kde.org/Guidelines_and_HOWTOs/ Licensing#License_Statements_in_Non-Source-Code_Files currently does not hold an example how to add SPDX tags. And by a quick look it seems not many docbook files in KDE repos currently have any such info, so no pattern could be derived from the real world samples. Also unclear to me how to best integrate with the predefined docbook tags, or if duplication is needed? Could we have some example given by those with insights? Cheers Friedrich