----boundary-LibPST-iamunique-1166822125_-_-
Content-type: text/plain
The discussion has identified several target audiences for documentation, with
differing needs. For exposing to potential users, it is necessary to have
accessibility via .pdf or .htm files, but for sharing "tricks" and "techniques"
among those using blackbox it would seem .odc files are sufficient and
preferable. Thus I would suggest only recipes that are introductory need to be
available in the other formats. Once one has decided to try blackbox, opening
in blackbox is easier, isn't it?
Assuming the CookBook was implemented similar to the Collection (html pages as
indexing and navigation, downloadable .odc files, with some also as .pdf), it
would also be nice if the entire CookBook was downloadable as a single
(structured) .odc document, for those who would rather do their perusing offline.
As an example of one solution to documentation (entire collection downloadable
as one document, individual topics available, search functions, etc.):
http://www.rebol.org/cgi-bin/cgiwrap/rebol/download-librarian.r
- Antony
Douglas G. Danforth wrote:
> Helmut,
> I have created an 'Open files' entry.
>
> I am still trying to decide on the best format for the CookBook. If I
> use CutePDFWriter then I get an exact replica of the .odc version of the
> CookBook as a .pdf file, however, hyperlinks don't work (I assume that
> if you create a pdf file in some way other than printing you can get
> hyperlinks (ne c'est pas?)).
>
> If I use HtmlExporter then I do not get an exact replica of the .odc
> file since the information in 'Rulers' is not passed to the .html file,
> e.g. centering text, tab stops, page breaks are not carried through.
>
> -Doug
>
--- BlackBox
--- send subject HELP or UNSUBSCRIBE to blackbox{([at]})nowhere.xy
----boundary-LibPST-iamunique-1166822125_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"
e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIFRoZSBkaXNjdXNzaW9uIGhhcyBpZGVudGlmaWVk
IHNldmVyYWwgdGFyZ2V0IGF1ZGllbmNlcyBmb3IgZG9jdW1lbnRhdGlvbiwgd2l0aCBccGFyDQpk
aWZmZXJpbmcgbmVlZHMuICBGb3IgZXhwb3NpbmcgdG8gcG90ZW50aWFsIHVzZXJzLCBpdCBpcyBu
ZWNlc3NhcnkgdG8gaGF2ZSBccGFyDQphY2Nlc3NpYmlsaXR5IHZpYSAucGRmIG9yIC5odG0gZmls
ZXMsIGJ1dCBmb3Igc2hhcmluZyAidHJpY2tzIiBhbmQgInRlY2huaXF1ZXMiIFxwYXINCmFtb25n
IHRob3NlIHVzaW5nIGJsYWNrYm94IGl0IHdvdWxkIHNlZW0gLm9kYyBmaWxlcyBhcmUgc3VmZmlj
aWVudCBhbmQgXHBhcg0KcHJlZmVyYWJsZS4gIFRodXMgSSB3b3VsZCBzdWdnZXN0IG9ubHkgcmVj
aXBlcyB0aGF0IGFyZSBpbnRyb2R1Y3RvcnkgbmVlZCB0byBiZSBccGFyDQphdmFpbGFibGUgaW4g
dGhlIG90aGVyIGZvcm1hdHMuICBPbmNlIG9uZSBoYXMgZGVjaWRlZCB0byB0cnkgYmxhY2tib3gs
IG9wZW5pbmcgXHBhcg0KaW4gYmxhY2tib3ggaXMgZWFzaWVyLCBpc24ndCBpdD9ccGFyDQpccGFy
DQpBc3N1bWluZyB0aGUgQ29va0Jvb2sgd2FzIGltcGxlbWVudGVkIHNpbWlsYXIgdG8gdGhlIENv
bGxlY3Rpb24gKGh0bWwgcGFnZXMgYXMgXHBhcg0KaW5kZXhpbmcgYW5kIG5hdmlnYXRpb24sIGRv
d25sb2FkYWJsZSAub2RjIGZpbGVzLCB3aXRoIHNvbWUgYWxzbyBhcyAucGRmKSwgaXQgXHBhcg0K
d291bGQgYWxzbyBiZSBuaWNlIGlmIHRoZSBlbnRpcmUgQ29va0Jvb2sgd2FzIGRvd25sb2FkYWJs
ZSBhcyBhIHNpbmdsZSBccGFyDQooc3RydWN0dXJlZCkgLm9kYyBkb2N1bWVudCwgZm9yIHRob3Nl
IHdobyB3b3VsZCByYXRoZXIgZG8gdGhlaXIgcGVydXNpbmcgb2ZmbGluZS5ccGFyDQpccGFyDQpB
cyBhbiBleGFtcGxlIG9mIG9uZSBzb2x1dGlvbiB0byBkb2N1bWVudGF0aW9uIChlbnRpcmUgY29s
bGVjdGlvbiBkb3dubG9hZGFibGUgXHBhcg0KYXMgb25lIGRvY3VtZW50LCBpbmRpdmlkdWFsIHRv
cGljcyBhdmFpbGFibGUsIHNlYXJjaCBmdW5jdGlvbnMsIGV0Yy4pOlxwYXINClxwYXINCmh0dHA6
Ly93d3cucmVib2wub3JnL2NnaS1iaW4vY2dpd3JhcC9yZWJvbC9kb3dubG9hZC1saWJyYXJpYW4u
clxwYXINClxwYXINCi0gQW50b255XHBhcg0KXHBhcg0KRG91Z2xhcyBHLiBEYW5mb3J0aCB3cm90
ZTpccGFyDQpccGFyDQo+IEhlbG11dCxccGFyDQo+IEkgaGF2ZSBjcmVhdGVkIGFuICdPcGVuIGZp
bGVzJyBlbnRyeS5ccGFyDQo+IFxwYXINCj4gSSBhbSBzdGlsbCB0cnlpbmcgdG8gZGVjaWRlIG9u
IHRoZSBiZXN0IGZvcm1hdCBmb3IgdGhlIENvb2tCb29rLiAgSWYgSSBccGFyDQo+IHVzZSBDdXRl
UERGV3JpdGVyIHRoZW4gSSBnZXQgYW4gZXhhY3QgcmVwbGljYSBvZiB0aGUgLm9kYyB2ZXJzaW9u
IG9mIHRoZSBccGFyDQo+IENvb2tCb29rIGFzIGEgLnBkZiBmaWxlLCBob3dldmVyLCBoeXBlcmxp
bmtzIGRvbid0IHdvcmsgKEkgYXNzdW1lIHRoYXQgXHBhcg0KPiBpZiB5b3UgY3JlYXRlIGEgcGRm
IGZpbGUgaW4gc29tZSB3YXkgb3RoZXIgdGhhbiBwcmludGluZyB5b3UgY2FuIGdldCBccGFyDQo+
IGh5cGVybGlua3MgKG5lIGMnZXN0IHBhcz8pKS5ccGFyDQo+IFxwYXINCj4gSWYgSSB1c2UgSHRt
bEV4cG9ydGVyIHRoZW4gSSBkbyBub3QgZ2V0IGFuIGV4YWN0IHJlcGxpY2Egb2YgdGhlIC5vZGMg
XHBhcg0KPiBmaWxlIHNpbmNlIHRoZSBpbmZvcm1hdGlvbiBpbiAnUnVsZXJzJyBpcyBub3QgcGFz
c2VkIHRvIHRoZSAuaHRtbCBmaWxlLCBccGFyDQo+IGUuZy4gY2VudGVyaW5nIHRleHQsIHRhYiBz
dG9wcywgcGFnZSBicmVha3MgYXJlIG5vdCBjYXJyaWVkIHRocm91Z2guXHBhcg0KPiBccGFyDQo+
IC1Eb3VnXHBhcg0KPiBccGFyDQpccGFyDQotLS0gQmxhY2tCb3hccGFyDQotLS0gc2VuZCBzdWJq
ZWN0IEhFTFAgb3IgVU5TVUJTQ1JJQkUgdG8gYmxhY2tib3hAb2Jlcm9uLmNofX0AQG9iZXJvbi5j
aA==
----boundary-LibPST-iamunique-1166822125_-_---
Received on Fri Apr 08 2005 - 21:42:47 UTC