----boundary-LibPST-iamunique-1100017519_-_-
Content-type: text/plain
Doug:
do not you think that the content CookBook itself is more important than
embedded graphics? For example, describing the menu sequence as
"File->Save as" is almost as good as providing a snapshot of the screen
with the menu pulled down. I am not sure whether providing screenshots
is essential in a system that is as customizable and evolvable as BB.
W.
> Antony,
> I have been sitting on your message thinking how to reply.
> I looked at your URL pointer and find it opaque in that I don't know of
> REBOL and I am reluctant to pursue it.
>
> I do agree with your comments about a single down loadable form for the
> CookBook for those with BlackBox.
>
> We are attempting to create extensions to HtmlConverter so that an exact
> replica of a single .odc version of the CookBook is created in .html
> (the CookBook may or may not be a single file).
> This will take a little bit of time.
>
> -Doug
>
> Antony Tersol wrote:
>> 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>>
>>
>
> --- BlackBox
> --- send subject HELP or UNSUBSCRIBE to blackbox{([at]})nowhere.xy>
>
--- BlackBox
--- send subject HELP or UNSUBSCRIBE to blackbox{([at]})nowhere.xy
----boundary-LibPST-iamunique-1100017519_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"
e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIERvdWc6XHBhcg0KXHBhcg0KICBkbyBub3QgeW91
IHRoaW5rIHRoYXQgdGhlIGNvbnRlbnQgQ29va0Jvb2sgaXRzZWxmIGlzIG1vcmUgaW1wb3J0YW50
IHRoYW5ccGFyDQplbWJlZGRlZCBncmFwaGljcz8gRm9yIGV4YW1wbGUsIGRlc2NyaWJpbmcgdGhl
IG1lbnUgc2VxdWVuY2UgYXNccGFyDQoiRmlsZS0+U2F2ZSBhcyIgaXMgYWxtb3N0IGFzIGdvb2Qg
YXMgcHJvdmlkaW5nIGEgc25hcHNob3Qgb2YgdGhlIHNjcmVlblxwYXINCndpdGggdGhlIG1lbnUg
cHVsbGVkIGRvd24uIEkgYW0gbm90IHN1cmUgd2hldGhlciBwcm92aWRpbmcgc2NyZWVuc2hvdHNc
cGFyDQppcyBlc3NlbnRpYWwgaW4gYSBzeXN0ZW0gdGhhdCBpcyBhcyBjdXN0b21pemFibGUgYW5k
IGV2b2x2YWJsZSBhcyBCQi5ccGFyDQpccGFyDQpXLlxwYXINClxwYXINCj4gQW50b255LFxwYXIN
Cj4gSSBoYXZlIGJlZW4gc2l0dGluZyBvbiB5b3VyIG1lc3NhZ2UgdGhpbmtpbmcgaG93IHRvIHJl
cGx5LlxwYXINCj4gSSBsb29rZWQgYXQgeW91ciBVUkwgcG9pbnRlciBhbmQgZmluZCBpdCBvcGFx
dWUgaW4gdGhhdCBJIGRvbid0IGtub3cgb2ZccGFyDQo+IFJFQk9MIGFuZCBJIGFtIHJlbHVjdGFu
dCB0byBwdXJzdWUgaXQuXHBhcg0KPlxwYXINCj4gSSBkbyBhZ3JlZSB3aXRoIHlvdXIgY29tbWVu
dHMgYWJvdXQgYSBzaW5nbGUgZG93biBsb2FkYWJsZSBmb3JtIGZvciB0aGVccGFyDQo+IENvb2tC
b29rIGZvciB0aG9zZSB3aXRoIEJsYWNrQm94LlxwYXINCj5ccGFyDQo+IFdlIGFyZSBhdHRlbXB0
aW5nIHRvIGNyZWF0ZSBleHRlbnNpb25zIHRvIEh0bWxDb252ZXJ0ZXIgc28gdGhhdCBhbiBleGFj
dFxwYXINCj4gcmVwbGljYSBvZiBhIHNpbmdsZSAub2RjIHZlcnNpb24gb2YgdGhlIENvb2tCb29r
IGlzIGNyZWF0ZWQgaW4gLmh0bWxccGFyDQo+ICh0aGUgQ29va0Jvb2sgbWF5IG9yIG1heSBub3Qg
YmUgYSBzaW5nbGUgZmlsZSkuXHBhcg0KPiBUaGlzIHdpbGwgdGFrZSBhIGxpdHRsZSBiaXQgb2Yg
dGltZS5ccGFyDQo+XHBhcg0KPiAtRG91Z1xwYXINCj5ccGFyDQo+IEFudG9ueSBUZXJzb2wgd3Jv
dGU6XHBhcg0KPj4gVGhlIGRpc2N1c3Npb24gaGFzIGlkZW50aWZpZWQgc2V2ZXJhbCB0YXJnZXQg
YXVkaWVuY2VzIGZvclxwYXINCj4+IGRvY3VtZW50YXRpb24sIHdpdGggZGlmZmVyaW5nIG5lZWRz
LiAgRm9yIGV4cG9zaW5nIHRvIHBvdGVudGlhbCB1c2VycyxccGFyDQo+PiBpdCBpcyBuZWNlc3Nh
cnkgdG8gaGF2ZSBhY2Nlc3NpYmlsaXR5IHZpYSAucGRmIG9yIC5odG0gZmlsZXMsIGJ1dCBmb3Jc
cGFyDQo+PiBzaGFyaW5nICJ0cmlja3MiIGFuZCAidGVjaG5pcXVlcyIgYW1vbmcgdGhvc2UgdXNp
bmcgYmxhY2tib3ggaXQgd291bGRccGFyDQo+PiBzZWVtIC5vZGMgZmlsZXMgYXJlIHN1ZmZpY2ll
bnQgYW5kIHByZWZlcmFibGUuICBUaHVzIEkgd291bGQgc3VnZ2VzdFxwYXINCj4+IG9ubHkgcmVj
aXBlcyB0aGF0IGFyZSBpbnRyb2R1Y3RvcnkgbmVlZCB0byBiZSBhdmFpbGFibGUgaW4gdGhlIG90
aGVyXHBhcg0KPj4gZm9ybWF0cy4gIE9uY2Ugb25lIGhhcyBkZWNpZGVkIHRvIHRyeSBibGFja2Jv
eCwgb3BlbmluZyBpbiBibGFja2JveCBpc1xwYXINCj4+IGVhc2llciwgaXNuJ3QgaXQ/XHBhcg0K
Pj5ccGFyDQo+PiBBc3N1bWluZyB0aGUgQ29va0Jvb2sgd2FzIGltcGxlbWVudGVkIHNpbWlsYXIg
dG8gdGhlIENvbGxlY3Rpb24gKGh0bWxccGFyDQo+PiBwYWdlcyBhcyBpbmRleGluZyBhbmQgbmF2
aWdhdGlvbiwgZG93bmxvYWRhYmxlIC5vZGMgZmlsZXMsIHdpdGggc29tZVxwYXINCj4+IGFsc28g
YXMgLnBkZiksIGl0IHdvdWxkIGFsc28gYmUgbmljZSBpZiB0aGUgZW50aXJlIENvb2tCb29rIHdh
c1xwYXINCj4+IGRvd25sb2FkYWJsZSBhcyBhIHNpbmdsZSAoc3RydWN0dXJlZCkgLm9kYyBkb2N1
bWVudCwgZm9yIHRob3NlIHdobyB3b3VsZFxwYXINCj4+IHJhdGhlciBkbyB0aGVpciBwZXJ1c2lu
ZyBvZmZsaW5lLlxwYXINCj4+XHBhcg0KPj4gQXMgYW4gZXhhbXBsZSBvZiBvbmUgc29sdXRpb24g
dG8gZG9jdW1lbnRhdGlvbiAoZW50aXJlIGNvbGxlY3Rpb25ccGFyDQo+PiBkb3dubG9hZGFibGUg
YXMgb25lIGRvY3VtZW50LCBpbmRpdmlkdWFsIHRvcGljcyBhdmFpbGFibGUsIHNlYXJjaFxwYXIN
Cj4+IGZ1bmN0aW9ucywgZXRjLik6XHBhcg0KPj5ccGFyDQo+PiBodHRwOi8vd3d3LnJlYm9sLm9y
Zy9jZ2ktYmluL2NnaXdyYXAvcmVib2wvZG93bmxvYWQtbGlicmFyaWFuLnJccGFyDQo+PlxwYXIN
Cj4+IC0gQW50b255XHBhcg0KPj5ccGFyDQo+PiBEb3VnbGFzIEcuIERhbmZvcnRoIHdyb3RlOlxw
YXINCj4+XHBhcg0KPj4+IEhlbG11dCxccGFyDQo+Pj4gSSBoYXZlIGNyZWF0ZWQgYW4gJ09wZW4g
ZmlsZXMnIGVudHJ5LlxwYXINCj4+PlxwYXINCj4+PiBJIGFtIHN0aWxsIHRyeWluZyB0byBkZWNp
ZGUgb24gdGhlIGJlc3QgZm9ybWF0IGZvciB0aGUgQ29va0Jvb2suICBJZiBJXHBhcg0KPj4+IHVz
ZSBDdXRlUERGV3JpdGVyIHRoZW4gSSBnZXQgYW4gZXhhY3QgcmVwbGljYSBvZiB0aGUgLm9kYyB2
ZXJzaW9uIG9mXHBhcg0KPj4+IHRoZSBDb29rQm9vayBhcyBhIC5wZGYgZmlsZSwgaG93ZXZlciwg
aHlwZXJsaW5rcyBkb24ndCB3b3JrIChJIGFzc3VtZVxwYXINCj4+PiB0aGF0IGlmIHlvdSBjcmVh
dGUgYSBwZGYgZmlsZSBpbiBzb21lIHdheSBvdGhlciB0aGFuIHByaW50aW5nIHlvdSBjYW5ccGFy
DQo+Pj4gZ2V0IGh5cGVybGlua3MgKG5lIGMnZXN0IHBhcz8pKS5ccGFyDQo+Pj5ccGFyDQo+Pj4g
SWYgSSB1c2UgSHRtbEV4cG9ydGVyIHRoZW4gSSBkbyBub3QgZ2V0IGFuIGV4YWN0IHJlcGxpY2Eg
b2YgdGhlIC5vZGNccGFyDQo+Pj4gZmlsZSBzaW5jZSB0aGUgaW5mb3JtYXRpb24gaW4gJ1J1bGVy
cycgaXMgbm90IHBhc3NlZCB0byB0aGUgLmh0bWxccGFyDQo+Pj4gZmlsZSwgZS5nLiBjZW50ZXJp
bmcgdGV4dCwgdGFiIHN0b3BzLCBwYWdlIGJyZWFrcyBhcmUgbm90IGNhcnJpZWRccGFyDQo+Pj4g
dGhyb3VnaC5ccGFyDQo+Pj5ccGFyDQo+Pj4gLURvdWdccGFyDQo+Pj5ccGFyDQo+PlxwYXINCj4+
IC0tLSBCbGFja0JveFxwYXINCj4+IC0tLSBzZW5kIHN1YmplY3QgSEVMUCBvciBVTlNVQlNDUklC
RSB0byBibGFja2JveEBvYmVyb24uY2hccGFyDQo+PlxwYXINCj4+XHBhcg0KPlxwYXINCj4gLS0t
IEJsYWNrQm94XHBhcg0KPiAtLS0gc2VuZCBzdWJqZWN0IEhFTFAgb3IgVU5TVUJTQ1JJQkUgdG8g
YmxhY2tib3hAb2Jlcm9uLmNoXHBhcg0KPlxwYXINCj5ccGFyDQpccGFyDQotLS0gQmxhY2tCb3hc
cGFyDQotLS0gc2VuZCBzdWJqZWN0IEhFTFAgb3IgVU5TVUJTQ1JJQkUgdG8gYmxhY2tib3hAb2Jl
cm9uLmNoXHBhcg0KXHBhcg0KfQ=
----boundary-LibPST-iamunique-1100017519_-_---
Received on Sat Apr 16 2005 - 16:40:08 UTC