Re: Relationship between doc directory and fontforge.github.io
T J <[email protected]> Mon, 11 Feb 2019 12:26:24 +0000
| Newsgroups | gmane.comp.fonts.fontforge.devel |
|---|---|
| Message-ID | <SYAPR01MB304049DD59610A82CFDA895AC2640@SYAPR01MB3040.ausprd01.prod.outlook.com> |
--===============1524323796257446570== Content-Language: en-AU Content-Type: multipart/alternative; boundary="_000_SYAPR01MB304049DD59610A82CFDA895AC2640SYAPR01MB3040ausp_" --_000_SYAPR01MB304049DD59610A82CFDA895AC2640SYAPR01MB3040ausp_ Content-Type: text/plain; charset="Windows-1252" Content-Transfer-Encoding: quoted-printable There is in effect, no relationship. The doc folder may be included in bund= led releases, depending on the package manager, but the website is fully co= ntrolled by updating http://github.com/fontforge/fontforge.github.io So if you wanted to sync the two, it=92d have to be done manually. Note tha= t repo has both the new (markdown) files, but also a copy of the old (plain= html) website, which probably more closely resembles the docs you find in = the main repo. There=92s probably a lot that could be done to improve on th= at. Jeremy ________________________________ From: Skef Iterum <[email protected]> Sent: Monday, February 11, 2019 10:25:27 PM To: [email protected] Subject: [fontforge-devel] Relationship between doc directory and fontforge= .github.io In my push requests that affected documentation I have made changes in the doc/html directory of the repository. The website repository has versions of those files in markdown. Can someone -- briefly, and at a high level -- walk me through the relationship between those two repository directories? No "judgment" is implied, I am just not sure whether I've missed some automated conversion script, or if the idea is to use a separate tool at release time, or just do a diff with the last release's commit and update manually. I'm interested in working on some of the items in meta/TODO.md -- particularly the anchor problem. I don't yet know much about Jekyll but I'm pretty adept with Pandoc at this point. But I would benefit from some general issue of how the whole system is intended to work in relation to new releases. Skef _______________________________________________ fontforge-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/fontforge-devel http://fontforge.10959.n7.nabble.com/Developer-f3.html --_000_SYAPR01MB304049DD59610A82CFDA895AC2640SYAPR01MB3040ausp_ Content-Type: text/html; charset="Windows-1252" Content-Transfer-Encoding: quoted-printable <html> <head> <meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3DWindows-1= 252"> <meta name=3D"Generator" content=3D"Microsoft Exchange Server"> <!-- converted from text --><style><!-- .EmailQuote { margin-left: 1pt; pad= ding-left: 4pt; border-left: #800000 2px solid; } --></style> </head> <body> <style> <!-- @font-face {font-family:"Cambria Math"} @font-face {font-family:"Yu Gothic"} @font-face {font-family:Calibri} @font-face {} p.x_MsoNormal, li.x_MsoNormal, div.x_MsoNormal {margin:0cm; margin-bottom:.0001pt; font-size:11.0pt; font-family:"Calibri",sans-serif} a:link, span.x_MsoHyperlink {color:blue; text-decoration:underline} a:visited, span.x_MsoHyperlinkFollowed {color:#954F72; text-decoration:underline} .x_MsoChpDefault {} @page WordSection1 {margin:72.0pt 72.0pt 72.0pt 72.0pt} div.x_WordSection1 {} --> </style> <div lang=3D"EN-AU" link=3D"blue" vlink=3D"#954F72"> <div class=3D"x_WordSection1"> <p class=3D"x_MsoNormal">There is in effect, no relationship. The doc folde= r may be included in bundled releases, depending on the package manager, bu= t the website is fully controlled by updating <a href=3D"http://github.com/fontforge/fontforge.github.io">http://github.c= om/fontforge/fontforge.github.io</a></p> <p class=3D"x_MsoNormal"> </p> <p class=3D"x_MsoNormal">So if you wanted to sync the two, it=92d have to b= e done manually. Note that repo has both the new (markdown) files, but also= a copy of the old (plain html) website, which probably more closely resemb= les the docs you find in the main repo. There=92s probably a lot that could be done to improve on that.</p> <p class=3D"x_MsoNormal"> </p> <p class=3D"x_MsoNormal">Jeremy</p> <p class=3D"x_MsoNormal"></p> <p class=3D"x_MsoNormal"> </p> </div> <hr tabindex=3D"-1" style=3D"display:inline-block; width:98%"> <div id=3D"x_divRplyFwdMsg" dir=3D"ltr"><font face=3D"Calibri, sans-serif" = color=3D"#000000" style=3D"font-size:11pt"><b>From:</b> Skef Iterum <git= [email protected]><br> <b>Sent:</b> Monday, February 11, 2019 10:25:27 PM<br> <b>To:</b> [email protected]<br> <b>Subject:</b> [fontforge-devel] Relationship between doc directory and fo= ntforge.github.io</font> <div> </div> </div> </div> <font size=3D"2"><span style=3D"font-size:11pt;"> <div class=3D"PlainText">In my push requests that affected documentation I = have made changes in <br> the doc/html directory of the repository. The website repository has <br> versions of those files in markdown. Can someone -- briefly, and at a <br> high level -- walk me through the relationship between those two <br> repository directories? No "judgment" is implied, I am just not s= ure <br> whether I've missed some automated conversion script, or if the idea is <br= > to use a separate tool at release time, or just do a diff with the last <br= > release's commit and update manually.<br> <br> I'm interested in working on some of the items in meta/TODO.md -- <br> particularly the anchor problem. I don't yet know much about Jekyll but <br= > I'm pretty adept with Pandoc at this point. But I would benefit from <br> some general issue of how the whole system is intended to work in <br> relation to new releases.<br> <br> Skef<br> <br> <br> <br> _______________________________________________<br> fontforge-devel mailing list<br> [email protected]<br> <a href=3D"https://lists.sourceforge.net/lists/listinfo/fontforge-devel">ht= tps://lists.sourceforge.net/lists/listinfo/fontforge-devel</a><br> <a href=3D"http://fontforge.10959.n7.nabble.com/Developer-f3.html">http://f= ontforge.10959.n7.nabble.com/Developer-f3.html</a><br> </div> </span></font> </body> </html> --_000_SYAPR01MB304049DD59610A82CFDA895AC2640SYAPR01MB3040ausp_-- --===============1524323796257446570== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --===============1524323796257446570== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ fontforge-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/fontforge-devel http://fontforge.10959.n7.nabble.com/Developer-f3.html --===============1524323796257446570==--