 | | Re: Format of FAQ items
|
|
(...) You mean like a master Table of Contents? Sure, okay. Question" How cautious do we want to get about creeping featuritis? :-, (...) Yep. (...) Oh, yeah. Integers are better for an enumerated value. (...) If you want to write the code for it, (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: Working sketch of FAQ item data format
|
|
(...) Would "Include" be better? (...) Sure, it looks like you're able to efficiently distinguish between a ng and a non-ng directory. (...) The top line looks good. I doubt we'd need the time-of-day stamp very often, if at all. Would it be possible (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Raw FAQ data format (Was: Format of FAQ items)
|
|
Todd Lehman (lehman@javanet.com) and Sproaticus (jsproat@geocities.com) writes lots of stuff: Guys! It sounds like you are mixing the raw data format and the presentation format. I'll try to stick to the raw data format here, and list the ideas I (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: I'll volunteer for the LEGO FAQ
|
|
(...) I don't think so. We should rather choose a separator for category levels: Category: [category] / [subcategory depth 1] / ... (...) Makes sense. (...) Lets use HTML. We can always use "lynx -dump" to generate plain text from the HTML edition. (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: Working sketch of FAQ item data format
|
|
(...) What does the Refer header mean? Say, due to what we figured out on the other thread, we can nix the Locations and Newsgroups headers, and just keep the Subject and Author headers. But doesn't the date belong on the same line is the author?... (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: Format of FAQ items
|
|
(...) What about an outline format? I made a cool little utility that displays, in outline format, any sub-tree of the global ng tree...so from any category sub-homepage you can see what's there beneath it -- especially handy for things like loc (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: FAQ data format possibilities
|
|
(...) I like index.* over title.* too. (...) The funny thing to me is the strange and unpredictable sequence that things have been unfolding in. It's not that it's got a life of its own which is not under any of our control to choose the sequencing, (...) (25 years ago, 24-Apr-99, to lugnet.faq)
|
| |
| | Re: Format of FAQ items
|
|
(...) Let me expand on this. It all depends on how it's converted into readable form. A one-file FAQ would certainly slurp everything in. An HTML conversion might take just the question titles to put up on the first page. Or maybe just the section's (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: obLEGO
|
|
(...) It's the repeated, frustrated sound you make when you open a Town Jr. set. It indicates a state of sticker shock. :-, Actually, "ob" is an abbreviation of "obligatory". Among other things, it's an old Usenet trick to insert an on-topic remark (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: FAQ data format possibilities
|
|
(...) Please see my comment regarding an index file title.en.faq : (URL) actual name of the file is unimportant.) You could then have title.fr.faq , title.es.faq , etc. (I think I now prefer "index" over "title" in the filename.) (...) It's funny (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | obLEGO
|
|
What does the 'ob' mean? Thanks! John (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: FAQ data format possibilities
|
|
(...) I've got a mechanism for this for the ng names so that, for example, "sf" is displayed as "San Francisco" -- but it isn't internationalized yet. Not sure how to handle subcategory names in the FAQ for virtual subcategories that don't yet (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Working sketch of FAQ item data format
|
|
(Originally in another thread. I gave it its own thread to make finding it and building upon it easier.) Here's a working sketch of the FAQ data format; in quasi-XML, to separate the files. <FILE NAME="file: /faq/lugnet/market/a...1.en.faq"> Refer: (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: Format of FAQ items
|
|
(...) You've convinced me otherwise now. Mea culpa. :-, (...) I think it would take in the whole sub-FAQ. This is (currently) my strategy for giving localized names to the different categories. Someone looking for starter questions could probably (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | (canceled)
|
|
|
| |
| | Re: Format of FAQ items
|
|
(...) How come? For specifying the ordering? For ease of editing? What about translations? Maintenance? Bookmarking? Grepping? (...) Something analogous to #include in C then? Would that slurp in an entire sub-FAQ? Or only relevant (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: FAQ data format possibilities
|
|
Todd, I read your post just after I put up my own. Ships in the night. :-P (...) 'Kay, I hadn't thought of that. I like it; the only real drawback I can see to this is how to phrase the category titles; e.g. translating: (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Re: FAQ data format possibilities
|
|
(...) Whoops, I forgot to list <UL>/<OL>/<LI> and <DL>/<DT>/<DD> -- gotta have those! Now this is getting into nesting... :) There are some good Perl5 modules that already exist for doing all of this (the HTML->text conversion, not the FAQing). (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | Format of FAQ items
|
|
Todd, I'm geared to start snarfing the RTL Auction & Shipping FAQ, to start giving form to the LUGNET FAQ. (LUGFAQ? :-) I am torn between two data formats, though it should be relatively easy to switch from one to the other. I think that whatever (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
| |
| | FAQ data format possibilities
|
|
(...) Separate files would make it even easier to parse. Also easier for editing, maintenance, and division of labor. Plenty simple to organize the individual translations using ISO 639 suffixes too, just like webpages, because then you can 'grep' (...) (25 years ago, 23-Apr-99, to lugnet.faq)
|
