Re: having trouble making changes to the handbook
Trevor Roydhouse wrote: Ernie Luzar wrote on 24/05/2017 03:43: One last thing. When I go to edit the chapter.xml content I see the text wraped in notation. Is there a special term that this "notation" is normally referred by? Are you referring to the tags which comprise the XML markup? Yes the "chapter.xml" files with content enclosed with < > like Is this markup notation referred to as "tags" or is "markup notations" the correct way to reference them as a group? Where are the intended usage meanings of all the different combinations of markup notations documented at? Looking at the online handbook and back tracking to the xml markup notation is not a easy method of identifying the xml markup notation to use to add new information to the handbook information. Now here is the really puzzling question. How would I write documentation about these xml markup notations showing the real xml markup notation code in the doc without it being interpreted as something that gets converted? example Here is what the xml markup notation code looks like;As seem in the raw code. which when seen from a browser would show as Here is what the xml markup notation code looks like; As seem in the raw code. ___ freebsd-doc@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: having trouble making changes to the handbook
Ernie Luzar wrote on 24/05/2017 21:53: Are you referring to the tags which comprise the XML markup? Yes the "chapter.xml" files with content enclosed with < > like Is this markup notation referred to as "tags" or is "markup notations" the correct way to reference them as a group? XML Markup comprises tags which are used to denote XML elements and attributes. Where are the intended usage meanings of all the different combinations of markup notations documented at? Looking at the online handbook and back tracking to the xml markup notation is not a easy method of identifying the xml markup notation to use to add new information to the handbook information. You need the DTD (document type definition) that is being used. The FreeBSD documentation uses the DocBook DTD. If you've already installed the textproc/docbook-xml port, the DTD is part of it. Now here is the really puzzling question. How would I write documentation about these xml markup notations showing the real xml markup notation code in the doc without it being interpreted as something that gets converted? example Here is what the xml markup notation code looks like;As seem in the raw code. You would use the less than and greater than XML character entities in place of the less than and greater than signs. For example,___ freebsd-doc@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
Re: having trouble making changes to the handbook
On 2017-05-24 13:53, Ernie Luzar wrote:
Where are the intended usage meanings of all the different combinations
of markup notations documented at? Looking at the online handbook and
back tracking to the xml markup notation is not a easy method of
identifying the xml markup notation to use to add new information to the
handbook information.
I think reading chapter 7 ("XML Primer"), 8 ("XHTML Markup") and 9
("DocBook Markup") of the FDP-Primer should answer most of your questions.
Bye, Andreas
___
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
[Bug 219421] [patch] handbook jail chapter removing ezjail section
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=219421 Brad Davis changed: What|Removed |Added Status|New |Closed CC||b...@freebsd.org Resolution|--- |Rejected --- Comment #2 from Brad Davis --- Yeah, we are not just going to commit a patch that removes a bunch of useful information and replaces it with nothing. If you really want to see this seriously considered, please submit with documentation on using the replacement method. -- You are receiving this mail because: You are the assignee for the bug. ___ freebsd-doc@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
