Re: 404 on manuals on lyx.org
Le 22/08/2017 à 19:08, Tommaso Cucinotta a écrit :
On 22/08/2017 09:08, Jean-Pierre Chrétien wrote:
-) 4 langs with complete 5 manuals on the page (Intro, Tutorial, UserGuide,
Math, Customization, EmbeddedObjects).
Additional is missing there, shouldn't it be added? It's kind of UserGuide2...
we have only 5 Additional.lyx manuals. For reference, this is the complete dump
[1]. What are the .16.lyx ones ?
I guess, manuals for lyx version 1.6 (last major release of the 1 series). I
don't think that this version is used anymore, but who knows?
The dump shows for current version:
- 7 real manuals: Intro, Tutorial, UserGuide, Math, Embedded, Customization
and Additional
- 2 help docs from automated build reflecting the local setup: Shortcuts,
LatexConfig
- 2 ancillary files: DummyDocument{1,2}
- 2 hidden documents (not appearing in the help menu): Formula-numbering,
MergedManuals
It misses:
- 1 help doc from automated build: Lyx Functions
- 14 specific help docs which are located in the examples folder
- 1 welcome file (example folder as well)
The example folder has localized subfolders.
I think that only the 7 real manuals and (possibly) the specialized ones should
appear in the wiki page. Maybe the MergedManuals would be useful also, if it can
be built in a an automated manner. The manuals are already searchable from
Edition>Search & Replace, but it would be a plus to be able to get the global plan.
--
Jean-Pierre
Re: 404 on manuals on lyx.org
On 22/08/2017 09:08, Jean-Pierre Chrétien wrote:
-) 4 langs with complete 5 manuals on the page (Intro, Tutorial, UserGuide,
Math, Customization, EmbeddedObjects).
Additional is missing there, shouldn't it be added? It's kind of UserGuide2...
we have only 5 Additional.lyx manuals. For reference, this is the complete dump
[1]. What are the .16.lyx ones ?
Thanks,
T.
[1]
$ find . -maxdepth 1 -name '*.lyx' | while read f; do echo ${f##./} $(find .
-name ${f##./} | wc -l); done | sort -k2 -nr
Intro.lyx 26
Tutorial.lyx 22
Shortcuts.lyx 8
UserGuide.lyx 5
Math.lyx 5
EmbeddedObjects.lyx 5
Customization.lyx 5
Additional.lyx 5
Formula-numbering.lyx 4
DummyDocument2.lyx 3
DummyDocument1.lyx 3
MergedManuals.lyx 2
LaTeXConfig.lyx 2
UserGuide.16.lyx 1
Tutorial.16.lyx 1
Shortcuts.16.lyx 1
MergedManuals.16.lyx 1
Math.16.lyx 1
LFUNs.lyx 1
LFUNs.16.lyx 1
LaTeXConfig.16.lyx 1
Intro.16.lyx 1
Formula-numbering.16.lyx 1
EmbeddedObjects.16.lyx 1
DummyDocument2.16.lyx 1
DummyDocument1.16.lyx 1
Development.lyx 1
Development.16.lyx 1
Customization.16.lyx 1
Additional.16.lyx 1
Re: 404 on manuals on lyx.org
Dear Tommaso, On 2017-08-21, Tommaso Cucinotta wrote: > I checked that, with the converted manuals from the > generate_manuals_for_web.sh script, we have: > -) 4 langs with complete 5 manuals on the page (Intro, Tutorial, >UserGuide, Math, Customization, EmbeddedObjects). > -) 22 langs with the Intro (18 besides the 4 complete langs) > -) 18 langs with the Tutorial (14 besides the 4 complete langs) > -) 17 langs with both Intro and Tutorial > But who knows how many of these are actually maintained and updated to > what LyX release ? > So, I was wondering whether it was worth to go for: > -) growing the current table to a maxi table (22 langs x 5 manuals) >with all possible intersections (likely different tables for >different doc types) No. > -) adding to the current table a new one, pointing only to the Intro & >Tutorial of the 22 langs having at least one of them. Yes. This would also allow to add a caveat: "these manuals may be outdated." > Thoughts ? I'd use a layout with the different formats of one document in one common cell: Manual English Français Deutsch Español IntroductionHTML HTML HTMLHTML LyX LyXLyX LyX PDF PDFPDF PDF TutorialHTML HTML HTMLHTM LyX LyXLyX LyX PDF PDFPDF PDF ... Additonal The HTML would be added once "fit for publication". Either fix major issues with the native export or use elyxer (exporting to LyX-2.0 format and then converting with elyxer should give better results, as the elyxer is quite old by now: "* eLyXer version 1.2.5 (2015-02-26)". Günter
Re: 404 on manuals on lyx.org
Le 21/08/2017 à 23:29, Tommaso Cucinotta a écrit : On 21/08/2017 23:09, Christian Ridderström wrote: - The link texts could be LyX vs PDF instead of EN/FR etc. tried also to play with the clikkable PDF/LyX icons that bring you to the file, but if we get tens of those I expect the page to become difficult to browse. I added example of how you can use an image as the "link text". Also how it can be resized. But it's better if the uploaded image has the proper size from the beginning. +1, thanks. I checked that, with the converted manuals from the generate_manuals_for_web.sh script, we have: -) 4 langs with complete 5 manuals on the page (Intro, Tutorial, UserGuide, Math, Customization, EmbeddedObjects). Additional is missing there, shouldn't it be added? It's kind of UserGuide2... -- Jean-Pierre
Re: 404 on manuals on lyx.org
On 21/08/2017 23:09, Christian Ridderström wrote: - The link texts could be LyX vs PDF instead of EN/FR etc. tried also to play with the clikkable PDF/LyX icons that bring you to the file, but if we get tens of those I expect the page to become difficult to browse. I added example of how you can use an image as the "link text". Also how it can be resized. But it's better if the uploaded image has the proper size from the beginning. +1, thanks. I checked that, with the converted manuals from the generate_manuals_for_web.sh script, we have: -) 4 langs with complete 5 manuals on the page (Intro, Tutorial, UserGuide, Math, Customization, EmbeddedObjects). -) 22 langs with the Intro (18 besides the 4 complete langs) -) 18 langs with the Tutorial (14 besides the 4 complete langs) -) 17 langs with both Intro and Tutorial But who knows how many of these are actually maintained and updated to what LyX release ? So, I was wondering whether it was worth to go for: -) growing the current table to a maxi table (22 langs x 5 manuals) with all possible intersections (likely different tables for different doc types) -) adding to the current table a new one, pointing only to the Intro & Tutorial of the 22 langs having at least one of them. Both would have to be auto-generated of course. Thoughts ? T.
Re: 404 on manuals on lyx.org
On 21/08/2017 17:02, Pavel Sanda wrote: https://wiki.lyx.org/uploads/ or from within wiki: uploads:/path/file.png solved, I was using "uploads:path/to/..." instead of "uploads:/path/to/..." A minor issue I'm seeing is that, clicking on a tutorial .lyx file in any language, Firefox proposes me to open the file with LyX, whilst clicking on any other .lyx document (not a tutorial), Firefox opens its text content in the webpage. Some misconfiguration of MIME types on the server ? Thanks, T.
Re: 404 on manuals on lyx.org
Tommaso Cucinotta writes: > On 20/08/2017 20:20, Christian Ridderström wrote: >> - Perhaps write out English, Español etc in the headings > > I made an attempt to rotate the text, to keep the table compact, via > CSS attributes, but the rotated one didn't show well, because it was > rotating the cell borders as well :(. Perhaps a hack might be to keep > the heading cell as a perfect square ;-P. I tested making the header text smaller, have a look at the playground page now. Looks ok to me, but maybe you think it's still to wide? >> - The link texts could be LyX vs PDF instead of EN/FR etc. > > tried to upload a .pdf icon from LyX, I've put it here: > Now, how can I get that image to show up in the wiki ? What is the URL > it becomes visible as ? I tried to follow pmwiki's (upload:, attach:), > but didn't work. Seems like you've solved it now. I added example of how you can use an image as the "link text". Also how it can be resized. But it's better if the uploaded image has the proper size from the beginning. /Christian
Re: 404 on manuals on lyx.org
Pavel Sanda wrote: > Tommaso Cucinotta wrote: > > Now, how can I get that image to show up in the wiki ? What is the URL it > > becomes visible as ? I tried to follow pmwiki's (upload:, attach:), but > > didn't work. > > https://wiki.lyx.org/uploads/ or from within wiki: uploads:/path/file.png p
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > Now, how can I get that image to show up in the wiki ? What is the URL it > becomes visible as ? I tried to follow pmwiki's (upload:, attach:), but > didn't work. https://wiki.lyx.org/uploads/ Pavel
Re: 404 on manuals on lyx.org
On 20/08/2017 20:20, Christian Ridderström wrote: - Perhaps write out English, Español etc in the headings I made an attempt to rotate the text, to keep the table compact, via CSS attributes, but the rotated one didn't show well, because it was rotating the cell borders as well :(. Perhaps a hack might be to keep the heading cell as a perfect square ;-P. - The link texts could be LyX vs PDF instead of EN/FR etc. tried to upload a .pdf icon from LyX, I've put it here: ftp wiki.lyx.org Connected to www.lyx.org. 220 Welcome to the LyX wiki FTP service. Name (wiki.lyx.org:tommaso): lyxftp 331 Please specify the password. Password: 230 Login successful. cd LyX cd Manuals put buffer-export_pdf.png dir -rw-r--r--1 ftp ftp 8170 Aug 21 12:46 buffer-export_pdf.png Now, how can I get that image to show up in the wiki ? What is the URL it becomes visible as ? I tried to follow pmwiki's (upload:, attach:), but didn't work. Do you mean how to make an image appear on a wiki page (http://www.pmwiki.org/wiki/PmWiki/Images) or how to upload an image onto the server? seemingly the upload part is ok, I just can't make it visible from a wiki page now. General tip: Test things in the group "/Test", e.g. see here http://wiki.lyx.org/Test/Images that's exactly what I was trying to follow :( Or use a playground page, e.g. http://wiki.lyx.org/Playground/AngusWikiSandbox moved Manuals2 to http://wiki.lyx.org/Playground/ManualsPG (feel free to edit, if you can let any image appear there, we're done!) Thx, T.
Re: 404 on manuals on lyx.org
Tommaso Cucinotta writes: > On 15/08/2017 22:11, Uwe Stöhr wrote: >> So fine with me if you change the order. > > done. Also, I gave a try to pmwiki tables, to get to a more compact form: > > http://wiki.lyx.org/LyX/Manuals2 The table looks nice to me. Some minor thoughts: - Perhaps write out English, Español etc in the headings - The link texts could be LyX vs PDF instead of EN/FR etc. - Perhaps state the LyX release before the table > (might be visually improved with some .lyx/.pdf icons, plus > country-code flags, but don't know how to attach images to the > lyx.org wiki) Do you mean how to make an image appear on a wiki page (http://www.pmwiki.org/wiki/PmWiki/Images) or how to upload an image onto the server? General tip: Test things in the group "/Test", e.g. see here http://wiki.lyx.org/Test/Images Or use a playground page, e.g. http://wiki.lyx.org/Playground/AngusWikiSandbox /Christian PS. It's a good idea to create a page like Manuals2 in the group Playground/ for others to review. Then when people like it, move improvements into LyX/Manuals. This is because we likely don't want to have two pages. This way we won't have to figure out how to delete a wiki page (which I've completely forgotten how to do). PPS. We can also consider maintaining an official page http://www.lyx.org/LyX/Manuals as the web pages are actually wiki pages, the task of creating and updating the page is the same.
Re: 404 on manuals on lyx.org
Pavel Sanda writes: > Yes, I will try to push our xhtml output to the web during next week or > two so more ppl can check the output with their own eyes. > I guess many of the bugs will rather easy-fix business. Where/which URL(s) and with what kind of structure did you intend to use? Also, are you planning one using two "areas" on the web? I.e. - An area (URL) for staging/testing/reviewing the pages - An area (URL) for the published/deployed/reviewed pages? I would recommend using two separate areas for robustness and convenience. And further that we'd tell bots to not index the staging/testing area. /Christian
Re: 404 on manuals on lyx.org
Uwe Stöhr writes: > El 11.08.2017 a las 08:35, Christian Ridderström escribió: > >> I can't do an anonymous login to ftp://ftp.lyx.de. Uwe wrote: > I'll try to repair it later today. I just tested and I still cannot do anonymous login to ftp://ftp.lyx.de. However, according to the message I get, I'm guessing anonymous isn't allowed => so it's probably the way it should be. >> I can do an anonymous login to http://ftp.lyx.de. Still works => good >> I am _not_ able to see the subfolder /Documentation/, so it's gone, moved >> or permissions changed. And this now also seem to work => good I also did a successful spot check and followed one of the links from the wiki page 'Manuals' => good. Thanks for fixing this Uwe. Best regards, Christian
Re: 404 on manuals on lyx.org
On Thu, Aug 17, 2017 at 01:14:14AM +0200, Pavel Sanda wrote: > Richard Heck wrote: > > Seriously, if we're really going to make the manuals available in this > > form, that will provide us with some motivation to fix the worst of the > > bugs with XHTML output. Often, this simply means making some design > > So here we go: at this moment I am not capable even to preview xhtml output > of math manual at all in firefox: > > XML Parsing Error: undefined entity Location: > file:///tmp/lyx_tmpdir.ddMdYjE28061/lyx_tmpbuf1/Math.xhtml > Line Number 7050, Column 13: > &imaginary; > ^ > > (MathML enabled in doc options.) I can reproduce that Firefox doesn't show the file. Chromium does but also shows the error. Unfortunately, xmllint does not catch an error, so our xhtml tests pass for Math. I tried different xmllint options but couldn't get one to give me an error for this. Scott signature.asc Description: PGP signature
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > Here you go, script attached, it compiles the main manuals for all Unf. this script still has quite some troubles. Mainly, because -E html instead of -E xhtml was used... My hack with copying to /tmp is not enough, because we use in manuals our toolbars icons as well and lyx will grab those stored at lyx root -- mangled filenames will have again the full path in it. To get this right, we will need to whole lyx root in tmp/ which kinda sucks... Pavel
Re: 404 on manuals on lyx.org
Richard Heck wrote: > Seriously, if we're really going to make the manuals available in this > form, that will provide us with some motivation to fix the worst of the > bugs with XHTML output. Often, this simply means making some design So here we go: at this moment I am not capable even to preview xhtml output of math manual at all in firefox: XML Parsing Error: undefined entity Location: file:///tmp/lyx_tmpdir.ddMdYjE28061/lyx_tmpbuf1/Math.xhtml Line Number 7050, Column 13: &imaginary; ^ (MathML enabled in doc options.) Pavel
Re: 404 on manuals on lyx.org
On 15/08/2017 22:11, Uwe Stöhr wrote: So fine with me if you change the order. done. Also, I gave a try to pmwiki tables, to get to a more compact form: http://wiki.lyx.org/LyX/Manuals2 (might be visually improved with some .lyx/.pdf icons, plus country-code flags, but don't know how to attach images to the lyx.org wiki) this might be a start for providing URLs for more languages (some of the) manuals are available into. Feedback welcome, thanks. T.
Re: 404 on manuals on lyx.org
El 15.08.2017 a las 11:43, Tommaso Cucinotta escribió: Great! One minor comment: probably the order of manuals might be exactly reversed, Hi Tommaso, thanks for having a look. As it is a Wiki please change it as you like. In the past I already had this sorting: Tutorial UserGuide Math Embeddedobjects Customization So fine with me if you change the order. Also, PDFs are a great help for people looking for info on the web, but HTML exports would probably be even better on the web... In principle yes, in practice no. eLyXer (http://pinchito.es/elyxer/) is no longer developed since 4 years but still produces much better results than LyX's own HTML converter. I reported the major issues: http://www.lyx.org/trac/ticket/9328 http://www.lyx.org/trac/ticket/10445 http://www.lyx.org/trac/ticket/10437 http://www.lyx.org/trac/ticket/10438 We all lack time so Richard is not to blame here. I am no real developer and therefore don't have the ability to work on the HTML converter issues. Maybe you could have a look and simply steal from eLyXer? I propose this way because the developer of eLyXer got a lot of feedback from me and LyX users and implemented almost everything people requested. ( Here are the other LyXHTML bugs: http://www.lyx.org/trac/query?status=accepted&status=assigned&status=new&status=reopened&summary=~&component=xhtml+export&description=~&reporter=~&col=id&col=summary&col=reporter&col=status&col=type&col=severity&col=keywords&desc=1&order=id ) Out of curiosity: this page links only manuals for a few languages, what about the plethora of others ? The LyX docs are only more or less complete in English, german, french, Spanish and Japanese. On Windows with MiKTeX I am not able to compile Japanese documents otherwise I would have uploaded also a Japanese version. OK, I am lazy because with TeXLive it works and I don't have the time to play around with TeXLive at the moment. regards Uwe
Re: 404 on manuals on lyx.org
On 15/08/2017 02:53, Uwe Stöhr wrote: I set it now again and updated the manuals to LyX 2.2.3: http://wiki.lyx.org/LyX/Manuals Great! One minor comment: probably the order of manuals might be exactly reversed, to have easier stuff first, and more advanced stuff last. Also, PDFs are a great help for people looking for info on the web, but HTML exports would probably be even better on the web... Out of curiosity: this page links only manuals for a few languages, what about the plethora of others ? Is that because these languages are the only ones for which we have a complete set of manuals ? my2c, T.
Re: 404 on manuals on lyx.org
El 13.08.2017 a las 15:04, Uwe Stöhr escribió: damn, I repaired this already few months ago. I also complained about this automatic permission removal at my hoster... it turned out that the Documentation folder even got lost. I set it now again and updated the manuals to LyX 2.2.3: http://wiki.lyx.org/LyX/Manuals regards Uwe
Re: 404 on manuals on lyx.org
Richard Heck wrote: > Seriously, if we're really going to make the manuals available in this > form, that will provide us with some motivation to fix the worst of the > bugs with XHTML output. Often, this simply means making some design > decisions. Implementing them is not difficult, since the output routines > are self-contained. I'm busy, as we all are, but I can do some of that > work and provide pointers if others want to do some of it. Yes, I will try to push our xhtml output to the web during next week or two so more ppl can check the output with their own eyes. I guess many of the bugs will rather easy-fix business. Pavel
Re: 404 on manuals on lyx.org
On 08/13/2017 11:49 AM, Pavel Sanda wrote: > Tommaso Cucinotta wrote: >> On 13/08/2017 17:33, Pavel Sanda wrote: >>> Maybe we are seeing different phenomena. Here EmbeddedObjects compiles >> [...] >>> Apart from that it looks sort of OK. TeXLive 2012 here :) >> yes, the difference seems that you're exporting xhtml, whilst I was >> exporting .html. > You mean you are not exporting to LyXHTML target? That's the only one we > have under control. HTML is likely going through external latex2html > package and we shouldn't aim to go primarily through that convertor... Uh, oh, here we go again Seriously, if we're really going to make the manuals available in this form, that will provide us with some motivation to fix the worst of the bugs with XHTML output. Often, this simply means making some design decisions. Implementing them is not difficult, since the output routines are self-contained. I'm busy, as we all are, but I can do some of that work and provide pointers if others want to do some of it. Richard
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > On 13/08/2017 17:33, Pavel Sanda wrote: >> Maybe we are seeing different phenomena. Here EmbeddedObjects compiles > [...] >> Apart from that it looks sort of OK. TeXLive 2012 here :) > > yes, the difference seems that you're exporting xhtml, whilst I was > exporting .html. You mean you are not exporting to LyXHTML target? That's the only one we have under control. HTML is likely going through external latex2html package and we shouldn't aim to go primarily through that convertor... Pavel
Re: 404 on manuals on lyx.org
On 13/08/2017 16:58, Tommaso Cucinotta wrote: On my system, despite having installed texlive-lang-all, not all of them succeed in compilation. I was missing xetex for the ja (and presumably he) languages. T.
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > Here you go, script attached, it compiles the main manuals for all > available languages, and auto-builds an index.html linking them all. Feel > free to add it to the LyX git (couldn't identify a suitable location in the > git tree for such a tool). > > On my system, despite having installed texlive-lang-all, not all of them > succeed in compilation. > > Result as can be seen at (file lyxdoc.tar.gz, once it's done uploading): > > https://drive.google.com/open?id=0B6A-8XYYe1nYUlg3U2YyQm0xQVU Cool! I will try to push this forward next week, to busy right now. Pavel
Re: 404 on manuals on lyx.org
On 13/08/2017 17:33, Pavel Sanda wrote: Maybe we are seeing different phenomena. Here EmbeddedObjects compiles [...] Apart from that it looks sort of OK. TeXLive 2012 here :) yes, the difference seems that you're exporting xhtml, whilst I was exporting .html. Just checked that the .xhtml out seems ok, instead the .html export is completely broken, I get on terminal a number of Empty picture! errors, and I just get a number of random PICT in the output, without anything / any text visible (see attached). T. LY X’s detailed Figure, Table, Floats, Notes, Boxes and External Material manual by the LY X Team* Version 2.2.x August 13, 2017 *If you have comments or error corrections, please send them to the LY X Documentation mailing list: lyx-d...@lists.lyx.org Contents
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > On 13/08/2017 12:48, Pavel Sanda wrote: >> You need latin,french&german to build the main (english) manuals? > > yes, latin for the "ipse lorum blah blah", french I suspect accidentally > tags a few English paragraphs in one of the manuals, whilst german is part > of the description of some of the inter-language features of LyX (umlauts, > accents, ...) can't remember more now. I checked now, it's the same with French (description of some example hack in Customization manual). > for now, EmbeddedObjects has been excluded from the auto-build in the > script I just sent. > I'm not understanding your explanation above of the problem. Maybe we are seeing different phenomena. Here EmbeddedObjects compiles into xhtml but in the middle of output it include couple of lines from some arbitraty .lyx file referenced by listings inset. That presumably works with latex, but with xhtml we (understandably) dump th whole .lyx file into the output. Apart from that it looks sort of OK. TeXLive 2012 here :) Pavel
Re: 404 on manuals on lyx.org
On 13/08/2017 12:48, Pavel Sanda wrote: You need latin,french&german to build the main (english) manuals? yes, latin for the "ipse lorum blah blah", french I suspect accidentally tags a few English paragraphs in one of the manuals, whilst german is part of the description of some of the inter-language features of LyX (umlauts, accents, ...) can't remember more now. -) Intro, UserGuide, Tutorial, Development, Math, Customization, Additional, LFUNs compile fine (pdf and html); -) major: I'm able to pdf-compile EmbeddedObjects, but HTML compilation has problems; I'd say it's 'solvable' if the .lyx file which is dumped via listings is changed to one which is much much shorter. It won't be fixed, but it wouldn't dump 30 pages of nonsense either... for now, EmbeddedObjects has been excluded from the auto-build in the script I just sent. I'm not understanding your explanation above of the problem. that has easy workaround along those lines (not supposed to be working out of the box): SVN_OUT=~/web/stabledoc/ W=/tmp/stabledoc B=~/lyx/stable/src/lyx got it, took into account into the script just sent. Thanks, T.
Re: 404 on manuals on lyx.org
Here you go, script attached, it compiles the main manuals for all available
languages, and auto-builds an index.html linking them all. Feel free to add it
to the LyX git (couldn't identify a suitable location in the git tree for such
a tool).
On my system, despite having installed texlive-lang-all, not all of them
succeed in compilation.
Result as can be seen at (file lyxdoc.tar.gz, once it's done uploading):
https://drive.google.com/open?id=0B6A-8XYYe1nYUlg3U2YyQm0xQVU
T.
On 13/08/2017 12:48, Pavel Sanda wrote:
Tommaso Cucinotta wrote:
On 11/08/2017 16:51, Pavel Sanda wrote:
I can prepare web corner for it on www.lyx.org if you decide to do it.
I quickly check the link you posted and the results seems good enough to
me to push it on the web if we can somewhat automatize it.
I gave a try to manual compilation of manuals :-), and here's the
experience:
-) minors along the way: I was missing texlive-lang-german, french, latin,
You need latin,french&german to build the main (english) manuals?
and texlive-humanities;
That's to be expected.
-) Intro, UserGuide, Tutorial, Development, Math, Customization,
Additional, LFUNs compile fine (pdf and html);
-) major: I'm able to pdf-compile EmbeddedObjects, but HTML compilation has
problems;
I'd say it's 'solvable' if the .lyx file which is dumped via listings
is changed to one which is much much shorter. It won't be fixed, but
it wouldn't dump 30 pages of nonsense either...
-) major: MergedManuals compilation complains about not being able to find
SpecialParagraphShape.tex or smth like that; that comes from
Additional.lyx, but Additional standalone compiles without problems, and
the .tex file is there, so why does it fail when embedded within
MergedManuals ?
We don't need the merged manuals at this stage, just the main manuals would be
good enough.
-) minor: converted HTML files include images with export names alike
55_home_tommaso_lyx-trunk-ws_lyx_*, which includes the absolute path I was
exporting from -- ideally, we shouldn't include any (mangled) absolute path
when exporting (but only (mangled) relative paths), is there a TT/# for
this ?
that has easy workaround along those lines (not supposed to be working out of
the box):
SVN_OUT=~/web/stabledoc/
W=/tmp/stabledoc
B=~/lyx/stable/src/lyx
#prepare
cd lyx; mkdir $W; cp -r lib/doc $W ; cd ${W}/doc
#export
for manual in tutorial.lyx userguide.lyx ... ; do
$B -E pdf $manual
$B -E xhtml $manual
done
#sum results html; similarly for pdf
for outman in tutorialdir userguidedir ... ; do
rm -r ${SVN_OUT}/$outman
cp -r $outman ${SVN_OUT}/$outman
done
It just needs someone to tune the above script for proper names,
switches and so on...
The rest is deploying to web via svn (I can take care of myself if I get
the above camera-ready).
Pavel
manuals_for_web.sh
Description: application/shellscript
Re: 404 on manuals on lyx.org
El 11.08.2017 a las 08:35, Christian Ridderström escribió: I can't do an anonymous login to ftp://ftp.lyx.de. I can do an anonymous login to http://ftp.lyx.de. I am _not_ able to see the subfolder /Documentation/, so it's gone, moved or permissions changed. Hi Christian, damn, I repaired this already few months ago. I also complained about this automatic permission removal at my hoster. They setup new software and it seems that this is the reason I lost my permission settings - AGAIN. I'll try to repair it later today. With our release frequency, it shouldn't be a problem to manually [*] update PDFs and upload the official manuals. I only used ft.lyx.de because I could not upload files anymore to wiki.lyx.org. Is this now again possible? if so I would switch back to wiki.lyx.org. How do I upload there files? thanks and regards Uwe
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote:
> On 11/08/2017 16:51, Pavel Sanda wrote:
>> I can prepare web corner for it on www.lyx.org if you decide to do it.
I quickly check the link you posted and the results seems good enough to
me to push it on the web if we can somewhat automatize it.
> I gave a try to manual compilation of manuals :-), and here's the
> experience:
> -) minors along the way: I was missing texlive-lang-german, french, latin,
You need latin,french&german to build the main (english) manuals?
> and texlive-humanities;
That's to be expected.
> -) Intro, UserGuide, Tutorial, Development, Math, Customization,
> Additional, LFUNs compile fine (pdf and html);
> -) major: I'm able to pdf-compile EmbeddedObjects, but HTML compilation has
> problems;
I'd say it's 'solvable' if the .lyx file which is dumped via listings
is changed to one which is much much shorter. It won't be fixed, but
it wouldn't dump 30 pages of nonsense either...
> -) major: MergedManuals compilation complains about not being able to find
> SpecialParagraphShape.tex or smth like that; that comes from
> Additional.lyx, but Additional standalone compiles without problems, and
> the .tex file is there, so why does it fail when embedded within
> MergedManuals ?
We don't need the merged manuals at this stage, just the main manuals would be
good enough.
> -) minor: converted HTML files include images with export names alike
> 55_home_tommaso_lyx-trunk-ws_lyx_*, which includes the absolute path I was
> exporting from -- ideally, we shouldn't include any (mangled) absolute path
> when exporting (but only (mangled) relative paths), is there a TT/# for
> this ?
that has easy workaround along those lines (not supposed to be working out of
the box):
SVN_OUT=~/web/stabledoc/
W=/tmp/stabledoc
B=~/lyx/stable/src/lyx
#prepare
cd lyx; mkdir $W; cp -r lib/doc $W ; cd ${W}/doc
#export
for manual in tutorial.lyx userguide.lyx ... ; do
$B -E pdf $manual
$B -E xhtml $manual
done
#sum results html; similarly for pdf
for outman in tutorialdir userguidedir ... ; do
rm -r ${SVN_OUT}/$outman
cp -r $outman ${SVN_OUT}/$outman
done
It just needs someone to tune the above script for proper names,
switches and so on...
The rest is deploying to web via svn (I can take care of myself if I get
the above camera-ready).
Pavel
Re: 404 on manuals on lyx.org
On 08/12/2017 10:11 AM, Tommaso Cucinotta wrote: > On 12/08/2017 15:52, Tommaso Cucinotta wrote: >> I gave a try to manual compilation of manuals :-), and here's the >> experience: >> -) minors along the way: I was missing texlive-lang-german, french, >> latin, and texlive-humanities; >> -) Intro, UserGuide, Tutorial, Development, Math, Customization, >> Additional, LFUNs compile fine (pdf and html); >> -) major: I'm able to pdf-compile EmbeddedObjects, but HTML >> compilation has problems; >> -) major: MergedManuals compilation complains about not being able to >> find SpecialParagraphShape.tex or smth like that; that comes from >> Additional.lyx, but Additional standalone compiles without problems, >> and the .tex file is there, so why does it fail when embedded within >> MergedManuals ? > > forgot: > > -) minor: converted HTML files include images with export names alike > 55_home_tommaso_lyx-trunk-ws_lyx_*, which includes the absolute path I > was exporting from -- ideally, we shouldn't include any (mangled) > absolute path when exporting (but only (mangled) relative paths), is > there a TT/# for this ? Not as far as I know. Sounds like a pretty easy fix. Richard
Re: 404 on manuals on lyx.org
On 08/12/2017 09:52 AM, Tommaso Cucinotta wrote: > > I gave a try to manual compilation of manuals :-), and here's the > experience: > -) minors along the way: I was missing texlive-lang-german, french, > latin, and texlive-humanities; > -) Intro, UserGuide, Tutorial, Development, Math, Customization, > Additional, LFUNs compile fine (pdf and html); I'd guess that there is probably some weirdness in the HTML version of the math manual, if one looks through it carefully. But it's good to know it at least works. The others I'd expect are fine, though with some glitches. > -) major: I'm able to pdf-compile EmbeddedObjects, but HTML > compilation has problems; This is not surprising. As I said in another message, Embedded Objects uses some advanced features that aren't well supported by LyXHTML. I've done some work in this, but there's a lot more to be done still. Richard
Re: 404 on manuals on lyx.org
On 12/08/2017 15:52, Tommaso Cucinotta wrote: I gave a try to manual compilation of manuals :-), and here's the experience: -) minors along the way: I was missing texlive-lang-german, french, latin, and texlive-humanities; -) Intro, UserGuide, Tutorial, Development, Math, Customization, Additional, LFUNs compile fine (pdf and html); -) major: I'm able to pdf-compile EmbeddedObjects, but HTML compilation has problems; -) major: MergedManuals compilation complains about not being able to find SpecialParagraphShape.tex or smth like that; that comes from Additional.lyx, but Additional standalone compiles without problems, and the .tex file is there, so why does it fail when embedded within MergedManuals ? forgot: -) minor: converted HTML files include images with export names alike 55_home_tommaso_lyx-trunk-ws_lyx_*, which includes the absolute path I was exporting from -- ideally, we shouldn't include any (mangled) absolute path when exporting (but only (mangled) relative paths), is there a TT/# for this ? Thx, T.
Re: 404 on manuals on lyx.org
On 11/08/2017 16:51, Pavel Sanda wrote: I can prepare web corner for it on www.lyx.org if you decide to do it. There's an autotest exporting manuals in a few formats that used to be troublesome (xhtml and lyx16x) in the past, in development/autotests/export-in.sh I gave a try to manual compilation of manuals :-), and here's the experience: -) minors along the way: I was missing texlive-lang-german, french, latin, and texlive-humanities; -) Intro, UserGuide, Tutorial, Development, Math, Customization, Additional, LFUNs compile fine (pdf and html); -) major: I'm able to pdf-compile EmbeddedObjects, but HTML compilation has problems; -) major: MergedManuals compilation complains about not being able to find SpecialParagraphShape.tex or smth like that; that comes from Additional.lyx, but Additional standalone compiles without problems, and the .tex file is there, so why does it fail when embedded within MergedManuals ? I dropped the result here: https://drive.google.com/drive/folders/0B6A-8XYYe1nYUlg3U2YyQm0xQVU?usp=sharing T.
Re: 404 on manuals on lyx.org
On 08/11/2017 07:03 AM, Pavel Sanda wrote: > Christian Ridderström wrote: >> I agree HTML pages online would be nice. >> Not sure if our manuals can (in a nice way) just be exported as HTML though. > Last time I tried (around 2009 and "merged manuals" idea) it did not came out > nicely. > IIRC I reported the issues, Richard might have fixed them since then... Some of the issues got fixed, but I haven't thad a lot of time to work on that in the last few years. Still, it would be some motivation. I think many of the manuals export fine. The Embedded Objects one, perhaps, not so well, but that uses a lot of more complex machinery. Richard
Re: 404 on manuals on lyx.org
On 2017-08-11, Christian Ridderström wrote: > On 11 August 2017 at 13:03, Pavel Sanda wrote: >> Christian Ridderström wrote: >> > [*] It might make sense to have a CI job that builds PDFs etc from the >> > manuals as a separate test. This is already done by Kornel's export test suite. All manuals are regularely exported and failures mailed to the list. There are known failures in additional tests for various "exotic" export routes and configurations but AFAIK all documentation exports fine using the set standard export format (mostly PDF(pdflatex)). >> The problem is you need to check them visually as well. Günter
Re: 404 on manuals on lyx.org
Le 11/08/2017 à 15:55, Christian Ridderström a écrit : In theory the procedure above could work on PDFs (or perhaps PS?), or possible PDFs converted to RTF or something else that's text based duh, perhaps HTML :-) What about using the command 'strings' (maybe with an appropriate option)? -- Jean-Pierre
Re: 404 on manuals on lyx.org
Tommaso Cucinotta wrote: > from my viewpoint, it would be good to have the manuals just available and > searchable on-line, i.e., when I'm looking for something on a search That was exactly the idea behind merged manuals. Fortunately some italian guy implemented advanced search through all manuals meanwhile :) > Albeit, someone pointed out previously that we purposely stop bots to avoid I don't think this would be any problem, because those pages would be static. Bots are problem with Trac, because each query launches costly backend. So it really boils down that someone (you?) is willing to sit down and write the script I envisioned. I can prepare web corner for it on www.lyx.org if you decide to do it. Pavel
Re: 404 on manuals on lyx.org
On 11/08/2017 15:55, Christian Ridderström wrote: simply to ensure that LyX doesn't fail when reading and exporting the manuals as PDFs. from my viewpoint, it would be good to have the manuals just available and searchable on-line, i.e., when I'm looking for something on a search engine, being redirected to either related topics throughout the manuals, or to related discussions throughout our mailing list archives, or related pages on the LyX wiki, would all be good things to have. Albeit, someone pointed out previously that we purposely stop bots to avoid our web server to be overloaded, which is understandable but not nice for visibility of LyX. Thanks, T.
Re: 404 on manuals on lyx.org
On 11 August 2017 at 13:03, Pavel Sanda wrote: > Christian Ridderström wrote: > > I agree HTML pages online would be nice. > > Not sure if our manuals can (in a nice way) just be exported as HTML > though. > > Last time I tried (around 2009 and "merged manuals" idea) it did not came > out nicely. > IIRC I reported the issues, Richard might have fixed them since then... > > > [*] It might make sense to have a CI job that builds PDFs etc from the > > manuals as a separate test. > > The problem is you need to check them visually as well. > I agree that checking the generated PDFs is the difficult part. However, in my mind the test's purpose is simply to ensure that LyX doesn't fail when reading and exporting the manuals as PDFs. This could catch introduced errors in HEAD, or if you let the TeX installation update itself, breakage due to that. > I guess once fixed we could just add one makefile rule to > 1. create all major manuals into pdf & html from tarball > 2. copy it to svn web tree, svn add new html figs > 3. commit it > > It just needs someone to sit and spend couple hours on it... I don't think the server autodeploys from SVN these days, but I could be wrong. Anyway, I didn't intend for such a CI job to also automatically publish the manuals/PDFs. IMHO, before publishing a new set of manuals some kind of manual review is necessary. /Christian [*] I have previously done some stuff that might be relevant/useful. E.g. in one project we got a large log file from a build that might somewhere contain a new error or warning message. Or perhaps one of thousands of values in the log output had changed although it shouldn't. Filtering for 'errror' and 'warning' is of course one way to go. Instead I introduced this approach: 1. Before one release, let two developers manually review the log file 2. Commit the reviewed log file as reference baseline (after fixing some things) 3. After each new build, automatically diff the generated log to the baseline. The diff, if any, had to be manually reviewed and if the changes were intentional and as expected we converted the newly generated log into a new reference for future builds. This worked well IMHO and it did help us catch some subtle bugs. However, the build situation was very different compared to that of LyX. I also introduced this approach for other "outputs", like big automatically generated data tables that were based on the source. Before 'diff:ing' we sometimes had to convert to another format, but it worked pretty well. In theory the procedure above could work on PDFs (or perhaps PS?), or possible PDFs converted to RTF or something else that's text based duh, perhaps HTML :-) It's a totally different question if the effort needed to setup the above is worth it though, which is why I thought of a simpler test that fails if LyX fails to export a PDF.
Re: 404 on manuals on lyx.org
Christian Ridderström wrote: > I agree HTML pages online would be nice. > Not sure if our manuals can (in a nice way) just be exported as HTML though. Last time I tried (around 2009 and "merged manuals" idea) it did not came out nicely. IIRC I reported the issues, Richard might have fixed them since then... > [*] It might make sense to have a CI job that builds PDFs etc from the > manuals as a separate test. The problem is you need to check them visually as well. I guess once fixed we could just add one makefile rule to 1. create all major manuals into pdf & html from tarball 2. copy it to svn web tree, svn add new html figs 3. commit it It just needs someone to sit and spend couple hours on it... Pavel
Re: 404 on manuals on lyx.org
On 11 August 2017 at 08:35, Christian Ridderström wrote: > On 8 August 2017 at 18:28, Tommaso Cucinotta wrote: > >> I just noticed these broken links >> >> http://wiki.lyx.org/LyX/Manuals#download >> http://ftp.lyx.de/Documentation/en/Customization.lyx >> http://ftp.lyx.de/Documentation/en/Customization.pdf >> >> guess they're all broken. >> > > I can't do an anonymous login to ftp://ftp.lyx.de. > I can do an anonymous login to http://ftp.lyx.de. > I am _not_ able to see the subfolder /Documentation/, so it's gone, moved > or permissions changed. > > IIRC, Uwe is related to this. CC:ing him. (to his @lyx.org-account, which > could be wrong) > > With our release frequency, it shouldn't be a problem to manually [*] > update PDFs and upload the official manuals. > > Scott, are the manuals and their updating perhaps related to your notes on > release procedure? > Scott wrote: > I don't currently have any notes on this, but it's possible this was > written somewhere and I missed it. Please let me know the exact steps > that I should take if I should handle it, and I will add those to my > notes. I think I remember more now and I think Uwe does it. I've now CCed his web.de-address thanks to Jean-Pierre. /Christian > > As the problem seems to be the access, perhaps what's needed is a CI job > that monitors that the FTP is working? > > There's also a seemingly outdated (from y 2009) merged manual available at: >> >> http://wiki.lyx.org/LyX/Documentation#toc2 >> https://wiki.lyx.org/uploads//LyX/Manuals/1.4.2/merged_manua >> ls/merged_manuals-1.4.2.pdf >> >> However, besides fixing the links, considering the powerful conversion >> capabilities of LyX, I'd propose to keep at least some manuals accessible >> as HTML pages on the web, rather than, or in addition to, .lyx/.pdf >> downloads. >> > > I agree HTML pages online would be nice. > Not sure if our manuals can (in a nice way) just be exported as HTML > though. > > /Christian > > [*] It might make sense to have a CI job that builds PDFs etc from the > manuals as a separate test. > >
Re: 404 on manuals on lyx.org
On Fri, Aug 11, 2017 at 08:35:04AM +0200, Christian Ridderström wrote: > Scott, are the manuals and their updating perhaps related to your notes on > release procedure? I don't currently have any notes on this, but it's possible this was written somewhere and I missed it. Please let me know the exact steps that I should take if I should handle it, and I will add those to my notes. Scott signature.asc Description: PGP signature
Re: 404 on manuals on lyx.org
Le 11/08/2017 à 08:35, Christian Ridderström a écrit : IIRC, Uwe is related to this. CC:ing him. (to his @lyx.org-account, which could be wrong) No it's right, but he prefers to get mails on his personal address uwesto...@web.de -- Jean-Pierre
Re: 404 on manuals on lyx.org
On 8 August 2017 at 18:28, Tommaso Cucinotta wrote: > I just noticed these broken links > > http://wiki.lyx.org/LyX/Manuals#download > http://ftp.lyx.de/Documentation/en/Customization.lyx > http://ftp.lyx.de/Documentation/en/Customization.pdf > > guess they're all broken. > I can't do an anonymous login to ftp://ftp.lyx.de. I can do an anonymous login to http://ftp.lyx.de. I am _not_ able to see the subfolder /Documentation/, so it's gone, moved or permissions changed. IIRC, Uwe is related to this. CC:ing him. (to his @lyx.org-account, which could be wrong) With our release frequency, it shouldn't be a problem to manually [*] update PDFs and upload the official manuals. Scott, are the manuals and their updating perhaps related to your notes on release procedure? As the problem seems to be the access, perhaps what's needed is a CI job that monitors that the FTP is working? There's also a seemingly outdated (from y 2009) merged manual available at: > > http://wiki.lyx.org/LyX/Documentation#toc2 > https://wiki.lyx.org/uploads//LyX/Manuals/1.4.2/merged_manua > ls/merged_manuals-1.4.2.pdf > > However, besides fixing the links, considering the powerful conversion > capabilities of LyX, I'd propose to keep at least some manuals accessible > as HTML pages on the web, rather than, or in addition to, .lyx/.pdf > downloads. > I agree HTML pages online would be nice. Not sure if our manuals can (in a nice way) just be exported as HTML though. /Christian [*] It might make sense to have a CI job that builds PDFs etc from the manuals as a separate test.
