Hi all, I am now having a problem formatting the source code in the quickbook. As documentation suggests, I put tab in front of the source code, and it appears preformatted in the browser, however there is no syntax hilighting nor gray backround. What could be wrong? Thanks, Arkadiy
Arkadiy Vertleyb wrote:
Hi all,
I am now having a problem formatting the source code in the quickbook. As documentation suggests, I put tab in front of the source code, and it appears preformatted in the browser, however there is no syntax hilighting nor gray backround.
What could be wrong?
Did you copy the CSS stylesheet from the quickdoc docs and place it in your html directory? Cheers, -- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net
All: I am going to propose a slight change of tack for Boost, and I may well be shot down for it; but first some context: <Context> After a series of language wars and what not at work, and coming to no resolution quickly (this I should note was well over a year ago now), I forwarded some proposals in private to our Consultancy Director, who came back and told me to just go ahead and act on them (effectively to develop a series of libs to underpin the next decade of our work); all the while the geese gaggled over C++, Java, Fortran, Python and almost anything else (the idea was to consolidate effort; there were too many languages, and too many specialities inside a small group). Needless to say, I coded in C++ and introduced Boost into the fray. The case now is that everyone now has their own ideas about which repository of third party tools are best - none though have an understanding of Boost, or seriously contemplate to study what it has to offer - despite now being a fundamental cornerstone of our future work (I'd like to think that it's just the natural response to change, I certainly hope it's nothing more though). </Context/> I am beginning to think that people pass over Boost for one of three reasons: a lack of exposure (be it junior or senior developers, and line managers with little or no development background); misplaced perceptions; or absent cognizance of how Boost can improve the quality and efficiency of C++ code. We need to make serious in-roads into Boost's image and reach into the community, developers and non-developers alike - something I think a lot of Boosters do seriously contemplate; I am just hoping to push the discussion beyond the bicycle shed, so to speak. As said above, I may be shot down for this proposal, but here it goes: Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects. It's blatant advertising I know, and much against the grain of what Boost stands for - we even have policy not to advertise commercial products in this forum (which I whole heartedly agree with). -Nonetheless we need to find ways, at least in some small crevice of the Boost web-site to advertise the use of Boost in industry. This is a tack clearly aimed at those unfamiliar with Boost, line managers, and developers alike without Boost experience can at least associate a product that they use, and say: "... oh, so Boost is behind much of that"; -it inspires confidence for take-up of the work and libraries here. It need not be said as a result of the above propsal, Boost becomes buoyed by perceptions of wider adoption, and commercial enterprise has another signpost to advertise the quality its processes by associating itself with Boost. Lastly, let me note that like everyone else here, I much value and want to safeguard the collegiate environment that makes up this group and do not want that to be compramised. -Please, let's get the ball rolling, maybe there are other suggestions far better than the one I've presented, and maybe convincing arguments against what I am advocating, but again, let's seriously consider ways to change our image for our greater good. If you got this far ... thanks for listening. And if I've stepped on a few toes, I do apolgize. Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects.
It's been suggested before, and met pretty much universal agreement, for some reason it's never been implemented.
If you got this far ... thanks for listening. And if I've stepped on a few toes, I do apolgize.
We've all got steel toe caps around here, so no need to apologise, especially if you're right ;-) John.
John Maddock wrote:
Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects.
It's been suggested before, and met pretty much universal agreement, for some reason it's never been implemented.
I really hope others are attune to this issue. I know quite a few are rather busy at this time, especially considering the work being put into the release of 1.33 ... but how might this issue be pushed along? ... It's often an up hill battle, when you're the one developer among 10 or so, who advocates Boost usage. (This is really another argument for following through with such a thing. It usually is one developer who sneaks Boost into an organization, and it would be really helpful if Boost as a whole could help plant that seed).
If you got this far ... thanks for listening. And if I've stepped on a few toes, I do apolgize.
We've all got steel toe caps around here, so no need to apologise, especially if you're right ;-)
That's comforting to be reminded of once in a while :-) Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
On Sat, 28 May 2005 19:55:55 +0800, Manfred Doudar wrote
John Maddock wrote:
Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects.
It's been suggested before, and met pretty much universal agreement, for some reason it's never been implemented.
Yep -- this discussion was one of the points made at our OOPSLA gathering. It's very simple -- many open source projects have a list of users. This list has a tendency to 'inspire confidence' in potential new users. http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?OOPSLA2004/Wo...
I really hope others are attune to this issue. I know quite a few are rather busy at this time, especially considering the work being put into the release of 1.33 ... but how might this issue be pushed along?
Yes, but like many great ideas associated with Boost the reason it hasn't been implemented is simply time and motivated volunteers. Of course we need to discuss 'how' to collect the information, but what we really need is a new contributors to take on the project... Here's some simple ways I can imagine gathering and implementing this: *Do an initial collection by making posts on various C++ lists and as people to send info about their usage of boost *Make a static web-page that is incorporated into the boost site *Establish a form on the boost pages which users can fill out to collect new information... *Somehow use the wiki for gathering this info... *etc... Jeff ps: I changed the title on the thread to hopefully attract more attention...
Yes, but like many great ideas associated with Boost the reason it hasn't been implemented is simply time and motivated volunteers. Of course we need to discuss 'how' to collect the information, but what we really need is a new contributors to take on the project...
Here's some simple ways I can imagine gathering and implementing this: *Do an initial collection by making posts on various C++ lists and as people to send info about their usage of boost *Make a static web-page that is incorporated into the boost site *Establish a form on the boost pages which users can fill out to collect new information... *Somehow use the wiki for gathering this info... *etc...
We also need a clear policy for what goes on the page, my initial thoughts are that as an incentive to users to "own up" we should allow: A company logo, where appropriate. A link to the home page of the product/organisation that's using Boost. A brief description of the product/organisation that's using Boost. In addition, the text should say which parts of Boost the product/organisation is using (anything else?). Glowing recommendations would be strictly optional ;-) Finally, before posting on a web page, we should have the permission of a "responsible person" in the organisation concerned, probably whoever does their public relations, this is obviously the tricky bit. If we could set up a trial page first, with 2 or 3 companies/products listed, so that potential customers can see what they're letting themselves in for, that would probably help as well. John.
On Sat, 28 May 2005 17:19:54 +0100, John Maddock wrote
We also need a clear policy for what goes on the page, my initial thoughts are that as an incentive to users to "own up" we should allow:
A company logo, where appropriate. A link to the home page of the product/organisation that's using Boost. A brief description of the product/organisation that's using Boost.
Hmm, not sure others do that. For example: http://www.cs.wustl.edu/~schmidt/ACE-users.html http://www.stack.nl/~dimitri/doxygen/projects.html BTW, I kind of think the 'powered-by' logo on the ACE page is a cool idea although I've never seen it used anywhere....
In addition, the text should say which parts of Boost the product/organisation is using (anything else?). Glowing recommendations would be strictly optional ;-)
Finally, before posting on a web page, we should have the permission of a "responsible person" in the organisation concerned, probably whoever does their public relations, this is obviously the tricky bit.
Yike -- that will cut down the number of them, but I suppose it needs to be done. If we do this, then this probably needs to just be an email to the 'list of users wizard' that is responsible for making the process work. Of course for other open source projects this wouldn't be necessary.
If we could set up a trial page first, with 2 or 3 companies/products listed, so that potential customers can see what they're letting themselves in for, that would probably help as well.
Sounds like a plan. BTW, one completely different approach would be to find users to write a 'success stories'. This is how KDE does some of this kind of 'advertising': http://enterprise.kde.org/bizcase/viewbytype.php Jeff
Jeff Garland wrote:
On Sat, 28 May 2005 17:19:54 +0100, John Maddock wrote
We also need a clear policy for what goes on the page, my initial thoughts are that as an incentive to users to "own up" we should allow:
A company logo, where appropriate. A link to the home page of the product/organisation that's using Boost. A brief description of the product/organisation that's using Boost.
Hmm, not sure others do that. For example:
http://www.cs.wustl.edu/~schmidt/ACE-users.html http://www.stack.nl/~dimitri/doxygen/projects.html
Since its been noted, I'd like to add my $0.02 on the doxygen projects page - in short, I think the simplicity of the page is its success - you can glance down the page, identify a product on the left, a short summary on the right, click on an interesting link and brief the product: ... it provides an easy way to associate someone's work, with something that you might also like to emulate, and whence in the case of doxygen, take up the tool for your own documentation purposes. On the other hand, Boost is not a documenation generator, and some words about explicit Boost integration into thrid party work is probably warranted. I guess what I am saying is that the right mix of presentation of the information is important here.
BTW, I kind of think the 'powered-by' logo on the ACE page is a cool idea although I've never seen it used anywhere....
That sounds kind of interesting - a 'powered by Boost' logo would be nice to spread the word too. Just a query though, if something did come out of the suggestion, could it ever be misused by third parties - I'd imagine for someone to have such a thing on their web-page advertising their association with Boost, that the such a logo would have conditions attached with its usage [to safegaurd Boost image]... (just a wild thought of the top of my head). (thoughts, ideas?)
If we could set up a trial page first, with 2 or 3 companies/products listed, so that potential customers can see what they're letting themselves in for, that would probably help as well.
Sounds like a plan.
Gee wiz, things move quickly here. :-)
BTW, one completely different approach would be to find users to write a 'success stories'. This is how KDE does some of this kind of 'advertising':
I guess my remarks about doxygen above are probably relevant here. Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
"John Maddock" <john@johnmaddock.co.uk> writes:
We also need a clear policy for what goes on the page, my initial thoughts are that as an incentive to users to "own up" we should allow:
A company logo, where appropriate. A link to the home page of the product/organisation that's using Boost. A brief description of the product/organisation that's using Boost.
In addition, the text should say which parts of Boost the product/organisation is using (anything else?). Glowing recommendations would be strictly optional ;-)
We can use http://www.boost.org/libs/python/doc/projects.html as a model/starting point.
Finally, before posting on a web page, we should have the permission of a "responsible person" in the organisation concerned, probably whoever does their public relations, this is obviously the tricky bit.
I don't think we need to do that kind of diligence. If we have heard from someone who we have reasonable confidence works for the company, that should be enough. If a company asks us to, we can always remove mention from the site. I do think it would be wrong to use a logo without special permission from someone in authority, but companies don't have any special right to control information about their use of Boost. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams wrote:
"John Maddock" <john@johnmaddock.co.uk> writes:
We also need a clear policy for what goes on the page, my initial thoughts are that as an incentive to users to "own up" we should allow:
A company logo, where appropriate. A link to the home page of the product/organisation that's using Boost. A brief description of the product/organisation that's using Boost.
In addition, the text should say which parts of Boost the product/organisation is using (anything else?). Glowing recommendations would be strictly optional ;-)
We can use http://www.boost.org/libs/python/doc/projects.html as a model/starting point.
It's a good a start as any, but more to the point it feels a little disjointed - that's not to say I could do better, I'm no visual artist but I guess in the larger context that is Boost, I'd find I think the way the information is put across is rather important. Others may have varying ideas I am sure, (I vaguely expressed what I thought was a good mix in another post [same thread], and how I thought that to degree the doxygen projects page was well done) ... except, the more I think about it, and the large nature that is Boost, I tend to feel that to effectively publicise Boost usage in third party work is something along the follwong lines: * Product/Company/Link: executive summary of product, and Boost association * Boost libraries used in product * (OPTIONAL) : personal comments/ glowing references [see reservation below] The one reservation I have is that the Optional personal comments/glowing refs seems a bit too (and pardon my language) "tacky", too sales like, and distracts from what would otherwise be a quick gaze to assess Boost usage - it should be more commercial/professsional and streamlined in its presentation (with ideally, another page for glowing references altogether if considered necessary). Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
David Abrahams a écrit :
I don't think we need to do that kind of diligence. If we have heard from someone who we have reasonable confidence works for the company, that should be enough. If a company asks us to, we can always remove mention from the site. I do think it would be wrong to use a logo without special permission from someone in authority, but companies don't have any special right to control information about their use of Boost.
Well, I'm not sure, but I think that many companies have some very strict policies about how their names are used, and even more their logos. I use boost at work in my company. But I guess that if I told you to use this company name, without checking with the company lawers and the communication department, I would get into trouble. What might happen is that many small companies would agree easily, but very few big companies, where administrative stuff is more "brazil-like". I'm not sure wether seing many name I've never heard of and no known name would be good or bad advertising. So I suggest that before getting such a page online, it would be good to wait until there are enough names, with some well knows ones. -- Loïc
Loïc Joly wrote:
David Abrahams a écrit :
I don't think we need to do that kind of diligence. If we have heard from someone who we have reasonable confidence works for the company, that should be enough. If a company asks us to, we can always remove mention from the site. I do think it would be wrong to use a logo without special permission from someone in authority, but companies don't have any special right to control information about their use of Boost.
Well, I'm not sure, but I think that many companies have some very strict policies about how their names are used, and even more their logos.
As David mentioned, special permission would be needed for logos. Use of company names I feel tends to be more relaxed, and I tend to concur with Dave that commercial entities have no particular right to control info about their use of Boost - but then again, I am no lawyer either (rather, just a humble mathematician who fell into software years ago). Does anyone know how other "project" pages garner such information? Are there any particular rules they need to comply with?
What might happen is that many small companies would agree easily, but very few big companies, where administrative stuff is more "brazil-like". I'm not sure wether seing many name I've never heard of and no known name would be good or bad advertising. So I suggest that before getting such a page online, it would be good to wait until there are enough names, with some well knows ones.
We really like going to the bicycle shed - I think it's too important for more than one reason to let this issue just slip by yet another time... Furthermore, advertising Boost, through companies big or small is worthwhile, I can't see the rationale for holding back until we get a few "big names". -Any how, I'm confident that there are "big names" using Boost anyway ... it can't be that hard, or could it be? Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
Loïc Joly <loic.actarus.joly@numericable.fr> writes:
David Abrahams a écrit :
I don't think we need to do that kind of diligence. If we have heard from someone who we have reasonable confidence works for the company, that should be enough. If a company asks us to, we can always remove mention from the site. I do think it would be wrong to use a logo without special permission from someone in authority, but companies don't have any special right to control information about their use of Boost.
Well, I'm not sure, but I think that many companies have some very strict policies about how their names are used,
In commercial advertising, yes. In general, no. I can write practically anything I want to about Microsoft, and use their name as much as I want, without fear of running afoul of their legal rights.
and even more their logos.
Yes, the logo is a copyrighted image, and can only be reproduced with the company's permission.
I use boost at work in my company. But I guess that if I told you to use this company name, without checking with the company lawers and the communication department, I would get into trouble.
But that's your problem, not Boost's. It's between you and your company.
What might happen is that many small companies would agree easily, but very few big companies, where administrative stuff is more "brazil-like".
One reason not to ask for permission ;-)
I'm not sure wether seing many name I've never heard of and no known name would be good or bad advertising. So I suggest that before getting such a page online, it would be good to wait until there are enough names, with some well knows ones.
You'll never even get started if you wait for that, IMO. -- Dave Abrahams Boost Consulting www.boost-consulting.com
Manfred Doudar <manfred.doudar@metoceanengineers.com> writes:
Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects.
It's blatant advertising I know,
I'd say it's blatant advertising for Boost, and somewhat subliminal advertising for those using Boost, provided they think that the use of Boost will reflect well upon their reputation.
and much against the grain of what Boost stands for
Not at all. http://www.boost.org/libs/python/doc/projects.html, for example. -- Dave Abrahams Boost Consulting www.boost-consulting.com
David Abrahams wrote:
Manfred Doudar <manfred.doudar@metoceanengineers.com> writes:
Under the pretext of my argument, I think it would be a good idea if Boost had as part of its offical web-site, an area where commercial enterprise can list their use of Boost in their projects.
It's blatant advertising I know,
I'd say it's blatant advertising for Boost,
In that case I now have no reservations about my initial proposal - Boost advertising is good advertising :-)
and somewhat subliminal advertising for those using Boost, provided they think that the use of Boost will reflect well upon their reputation.
and much against the grain of what Boost stands for
Not at all. http://www.boost.org/libs/python/doc/projects.html, for example.
Not having ventured down the Python path with Boost, I was previously unaware of the "projects" page. Boost indeed is many things, and that's comforting, it shifts my own perceptions a little (for the better) - thanks Dave. Cheers, -- Manfred Doudar MetOcean Engineers www.metoceanengineers.com
"Joel de Guzman" <joel@boost-consulting.com> wrote
Arkadiy Vertleyb wrote:
Hi all,
I am now having a problem formatting the source code in the quickbook. As documentation suggests, I put tab in front of the source code, and it appears preformatted in the browser, however there is no syntax hilighting nor gray backround.
What could be wrong?
Did you copy the CSS stylesheet from the quickdoc docs and place it in your html directory?
I didn't... now it works. Thanks a lot! Regards, Arkadiy
participants (7)
-
Arkadiy Vertleyb -
David Abrahams -
Jeff Garland -
Joel de Guzman -
John Maddock -
Loïc Joly -
Manfred Doudar