You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tuscany.apache.org by Dan Becker <da...@gmail.com> on 2008/11/18 21:35:45 UTC
Boosting Tuscany web presence - improving consumability
I noticed one of the best ways of boosting Confluence search results for
Tuscany wiki pages is to tag the pages. Even the simplest, nearly-empty
page with a single tag will show up higher in wiki search results than
the most detailed, lengthy, important treatise without tags. Since
Confluence searches span multiple Apache projects, it will be to
Tuscany's benefit to show up higher in search results. (Hopefully these
labels are added as meta tags for external search engines too.)
Another benefit is that when a user clicks on a label, the user is
presented with a list of similar articles. Much better than navigating a
big hierarchy.
Adding labels is easy. When you are viewing or editing a page on the
Tuscany wiki, you should see a small "Labels" text below the page view
and info tabs. There will be either a list of labels or "(None)" if
there are no labels. If you are logged into Confluence, you will get a
small yellow edit text label as well. Click on this edit label to add
existing tags or to make up new ones.
I just went through a bunch of Tuscany pages and added a large set of
tags. Ideas include: osgi, testing, presentations, data-bindings,
web-services, architecture, videos, etc. Please help tag our articles.
--
Thanks, Dan Becker
Re: Boosting Tuscany web presence - improving consumability
Posted by Luciano Resende <lu...@gmail.com>.
I have added the description and keywords metadata to the confluence
template that is used to export our website contents to html under svn
revision #731787. I have also forced an Confluence export, and you
could check the results at [1] while we wait for the live website to
sync.
[1] http://cwiki.apache.org/TUSCANY/home.html
On Wed, Nov 19, 2008 at 6:44 AM, Dan Becker <da...@gmail.com> wrote:
> Hmm, it looks like you can use the $page.id to get a list of labels:
> Vector getLabelsById(String token, long objectId)
>
> Now we must find a way to turn the vector of labels into an HTML header tag
> like:
> <meta name="keywords" content="architecture, wsdl, data-binding">
>
>
> Luciano Resende wrote:
>>
>> We control the template [1], we just need to play with it...
>>
>> [1]
>> https://svn.apache.org/repos/asf/tuscany/site/templates/TUSCANY_confluence_html_export.xml
>>
>> On Tue, Nov 18, 2008 at 2:13 PM, Simon Laws <si...@googlemail.com>
>> wrote:
>>>
>>> On Tue, Nov 18, 2008 at 9:14 PM, Luciano Resende <lu...@gmail.com>
>>> wrote:
>>>>
>>>> There is a template we use for exporting the confluence pages to html.
>>>> Let me look if I can make something that would add the confluence tags
>>>> to the pages, or at least add a fixed set of keywords to all tags.
>>>>
>>>> On Tue, Nov 18, 2008 at 1:12 PM, Dan Becker <da...@gmail.com>
>>>> wrote:
>>>>>
>>>>> Simon Laws wrote:
>>>>>>
>>>>>> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com>
>>>>>> wrote:
>>>>>>
>>>>>>> I noticed one of the best ways of boosting Confluence search results
>>>>>>> for
>>>>>>> Tuscany wiki pages is to tag the pages. Even the simplest,
>>>>>>> nearly-empty
>>>>>>> page
>>>>>>> with a single tag will show up higher in wiki search results than the
>>>>>>> most
>>>>>>> detailed, lengthy, important treatise without tags. Since Confluence
>>>>>>> searches span multiple Apache projects, it will be to Tuscany's
>>>>>>> benefit
>>>>>>> to
>>>>>>> show up higher in search results. (Hopefully these labels are added
>>>>>>> as
>>>>>>> meta
>>>>>>> tags for external search engines too.)
>>>>>>>
>>>>>>> Another benefit is that when a user clicks on a label, the user is
>>>>>>> presented with a list of similar articles. Much better than
>>>>>>> navigating
>>>>>>> a
>>>>>>> big
>>>>>>> hierarchy.
>>>>>>>
>>>>>>> Adding labels is easy. When you are viewing or editing a page on the
>>>>>>> Tuscany wiki, you should see a small "Labels" text below the page
>>>>>>> view
>>>>>>> and
>>>>>>> info tabs. There will be either a list of labels or "(None)" if there
>>>>>>> are
>>>>>>> no
>>>>>>> labels. If you are logged into Confluence, you will get a small
>>>>>>> yellow
>>>>>>> edit
>>>>>>> text label as well. Click on this edit label to add existing tags or
>>>>>>> to
>>>>>>> make
>>>>>>> up new ones.
>>>>>>>
>>>>>>> I just went through a bunch of Tuscany pages and added a large set of
>>>>>>> tags.
>>>>>>> Ideas include: osgi, testing, presentations, data-bindings,
>>>>>>> web-services,
>>>>>>> architecture, videos, etc. Please help tag our articles.
>>>>>>
>>>>>> I just tried a couple to see what happens. Do you know the tags get
>>>>>> applied
>>>>>> to the HTML?
>>>>>>
>>>>> Good HTML pages will include meta tags such as "keywords" and
>>>>> "description"
>>>>> to help search engines and web crawlers identify and categorize the web
>>>>> page.
>>>>>
>>>>> Unfortunately the internal Confluence wiki pages seems to provide no
>>>>> meta
>>>>> tags made from the page labels. On the other hand, the Confluence
>>>>> search
>>>>> algorithm appears to make use of these labels heavily.
>>>>>
>>>>> The external pages do have meta tags for "Content-Type", but I have not
>>>>> seen
>>>>> any for keywords. I have added a few more labels there, so let me check
>>>>> in a
>>>>> day or so to see if they have been published and propagated externally.
>>>>>
>>>>> I am no Confluence expert, but perhaps someone knows if we can publish
>>>>> the
>>>>> tags? Is there a publish option somewhere?
>>>>>
>>>>> --
>>>>> Thanks, Dan Becker
>>>>>
>>>>
>>>>
>>>> --
>>>> Luciano Resende
>>>> Apache Tuscany, Apache PhotArk
>>>> http://people.apache.org/~lresende
>>>> http://lresende.blogspot.com/
>>>
>>> How much control do we have over the template? Can we pull the confluence
>>> tags and insert them into the HTML so that Google is likely to find them
>>> in
>>> one of the usual ways.
>>>
>>> Simon
>>>
>>
>>
>>
>
>
> --
> Thanks, Dan Becker
>
--
Luciano Resende
Apache Tuscany, Apache PhotArk
http://people.apache.org/~lresende
http://lresende.blogspot.com/
Re: Boosting Tuscany web presence - improving consumability
Posted by Dan Becker <da...@gmail.com>.
Hmm, it looks like you can use the $page.id to get a list of labels:
Vector getLabelsById(String token, long objectId)
Now we must find a way to turn the vector of labels into an HTML header
tag like:
<meta name="keywords" content="architecture, wsdl, data-binding">
Luciano Resende wrote:
> We control the template [1], we just need to play with it...
>
> [1] https://svn.apache.org/repos/asf/tuscany/site/templates/TUSCANY_confluence_html_export.xml
>
> On Tue, Nov 18, 2008 at 2:13 PM, Simon Laws <si...@googlemail.com> wrote:
>>
>> On Tue, Nov 18, 2008 at 9:14 PM, Luciano Resende <lu...@gmail.com>
>> wrote:
>>> There is a template we use for exporting the confluence pages to html.
>>> Let me look if I can make something that would add the confluence tags
>>> to the pages, or at least add a fixed set of keywords to all tags.
>>>
>>> On Tue, Nov 18, 2008 at 1:12 PM, Dan Becker <da...@gmail.com>
>>> wrote:
>>>> Simon Laws wrote:
>>>>> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com>
>>>>> wrote:
>>>>>
>>>>>> I noticed one of the best ways of boosting Confluence search results
>>>>>> for
>>>>>> Tuscany wiki pages is to tag the pages. Even the simplest,
>>>>>> nearly-empty
>>>>>> page
>>>>>> with a single tag will show up higher in wiki search results than the
>>>>>> most
>>>>>> detailed, lengthy, important treatise without tags. Since Confluence
>>>>>> searches span multiple Apache projects, it will be to Tuscany's
>>>>>> benefit
>>>>>> to
>>>>>> show up higher in search results. (Hopefully these labels are added as
>>>>>> meta
>>>>>> tags for external search engines too.)
>>>>>>
>>>>>> Another benefit is that when a user clicks on a label, the user is
>>>>>> presented with a list of similar articles. Much better than navigating
>>>>>> a
>>>>>> big
>>>>>> hierarchy.
>>>>>>
>>>>>> Adding labels is easy. When you are viewing or editing a page on the
>>>>>> Tuscany wiki, you should see a small "Labels" text below the page view
>>>>>> and
>>>>>> info tabs. There will be either a list of labels or "(None)" if there
>>>>>> are
>>>>>> no
>>>>>> labels. If you are logged into Confluence, you will get a small yellow
>>>>>> edit
>>>>>> text label as well. Click on this edit label to add existing tags or
>>>>>> to
>>>>>> make
>>>>>> up new ones.
>>>>>>
>>>>>> I just went through a bunch of Tuscany pages and added a large set of
>>>>>> tags.
>>>>>> Ideas include: osgi, testing, presentations, data-bindings,
>>>>>> web-services,
>>>>>> architecture, videos, etc. Please help tag our articles.
>>>>> I just tried a couple to see what happens. Do you know the tags get
>>>>> applied
>>>>> to the HTML?
>>>>>
>>>> Good HTML pages will include meta tags such as "keywords" and
>>>> "description"
>>>> to help search engines and web crawlers identify and categorize the web
>>>> page.
>>>>
>>>> Unfortunately the internal Confluence wiki pages seems to provide no
>>>> meta
>>>> tags made from the page labels. On the other hand, the Confluence search
>>>> algorithm appears to make use of these labels heavily.
>>>>
>>>> The external pages do have meta tags for "Content-Type", but I have not
>>>> seen
>>>> any for keywords. I have added a few more labels there, so let me check
>>>> in a
>>>> day or so to see if they have been published and propagated externally.
>>>>
>>>> I am no Confluence expert, but perhaps someone knows if we can publish
>>>> the
>>>> tags? Is there a publish option somewhere?
>>>>
>>>> --
>>>> Thanks, Dan Becker
>>>>
>>>
>>>
>>> --
>>> Luciano Resende
>>> Apache Tuscany, Apache PhotArk
>>> http://people.apache.org/~lresende
>>> http://lresende.blogspot.com/
>> How much control do we have over the template? Can we pull the confluence
>> tags and insert them into the HTML so that Google is likely to find them in
>> one of the usual ways.
>>
>> Simon
>>
>
>
>
--
Thanks, Dan Becker
Re: Boosting Tuscany web presence - improving consumability
Posted by Luciano Resende <lu...@gmail.com>.
We control the template [1], we just need to play with it...
[1] https://svn.apache.org/repos/asf/tuscany/site/templates/TUSCANY_confluence_html_export.xml
On Tue, Nov 18, 2008 at 2:13 PM, Simon Laws <si...@googlemail.com> wrote:
>
>
> On Tue, Nov 18, 2008 at 9:14 PM, Luciano Resende <lu...@gmail.com>
> wrote:
>>
>> There is a template we use for exporting the confluence pages to html.
>> Let me look if I can make something that would add the confluence tags
>> to the pages, or at least add a fixed set of keywords to all tags.
>>
>> On Tue, Nov 18, 2008 at 1:12 PM, Dan Becker <da...@gmail.com>
>> wrote:
>> > Simon Laws wrote:
>> >>
>> >> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com>
>> >> wrote:
>> >>
>> >>> I noticed one of the best ways of boosting Confluence search results
>> >>> for
>> >>> Tuscany wiki pages is to tag the pages. Even the simplest,
>> >>> nearly-empty
>> >>> page
>> >>> with a single tag will show up higher in wiki search results than the
>> >>> most
>> >>> detailed, lengthy, important treatise without tags. Since Confluence
>> >>> searches span multiple Apache projects, it will be to Tuscany's
>> >>> benefit
>> >>> to
>> >>> show up higher in search results. (Hopefully these labels are added as
>> >>> meta
>> >>> tags for external search engines too.)
>> >>>
>> >>> Another benefit is that when a user clicks on a label, the user is
>> >>> presented with a list of similar articles. Much better than navigating
>> >>> a
>> >>> big
>> >>> hierarchy.
>> >>>
>> >>> Adding labels is easy. When you are viewing or editing a page on the
>> >>> Tuscany wiki, you should see a small "Labels" text below the page view
>> >>> and
>> >>> info tabs. There will be either a list of labels or "(None)" if there
>> >>> are
>> >>> no
>> >>> labels. If you are logged into Confluence, you will get a small yellow
>> >>> edit
>> >>> text label as well. Click on this edit label to add existing tags or
>> >>> to
>> >>> make
>> >>> up new ones.
>> >>>
>> >>> I just went through a bunch of Tuscany pages and added a large set of
>> >>> tags.
>> >>> Ideas include: osgi, testing, presentations, data-bindings,
>> >>> web-services,
>> >>> architecture, videos, etc. Please help tag our articles.
>> >>
>> >> I just tried a couple to see what happens. Do you know the tags get
>> >> applied
>> >> to the HTML?
>> >>
>> >
>> > Good HTML pages will include meta tags such as "keywords" and
>> > "description"
>> > to help search engines and web crawlers identify and categorize the web
>> > page.
>> >
>> > Unfortunately the internal Confluence wiki pages seems to provide no
>> > meta
>> > tags made from the page labels. On the other hand, the Confluence search
>> > algorithm appears to make use of these labels heavily.
>> >
>> > The external pages do have meta tags for "Content-Type", but I have not
>> > seen
>> > any for keywords. I have added a few more labels there, so let me check
>> > in a
>> > day or so to see if they have been published and propagated externally.
>> >
>> > I am no Confluence expert, but perhaps someone knows if we can publish
>> > the
>> > tags? Is there a publish option somewhere?
>> >
>> > --
>> > Thanks, Dan Becker
>> >
>>
>>
>>
>> --
>> Luciano Resende
>> Apache Tuscany, Apache PhotArk
>> http://people.apache.org/~lresende
>> http://lresende.blogspot.com/
>
> How much control do we have over the template? Can we pull the confluence
> tags and insert them into the HTML so that Google is likely to find them in
> one of the usual ways.
>
> Simon
>
--
Luciano Resende
Apache Tuscany, Apache PhotArk
http://people.apache.org/~lresende
http://lresende.blogspot.com/
Re: Boosting Tuscany web presence - improving consumability
Posted by Simon Laws <si...@googlemail.com>.
On Tue, Nov 18, 2008 at 9:14 PM, Luciano Resende <lu...@gmail.com>wrote:
> There is a template we use for exporting the confluence pages to html.
> Let me look if I can make something that would add the confluence tags
> to the pages, or at least add a fixed set of keywords to all tags.
>
> On Tue, Nov 18, 2008 at 1:12 PM, Dan Becker <da...@gmail.com>
> wrote:
> > Simon Laws wrote:
> >>
> >> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com>
> >> wrote:
> >>
> >>> I noticed one of the best ways of boosting Confluence search results
> for
> >>> Tuscany wiki pages is to tag the pages. Even the simplest, nearly-empty
> >>> page
> >>> with a single tag will show up higher in wiki search results than the
> >>> most
> >>> detailed, lengthy, important treatise without tags. Since Confluence
> >>> searches span multiple Apache projects, it will be to Tuscany's benefit
> >>> to
> >>> show up higher in search results. (Hopefully these labels are added as
> >>> meta
> >>> tags for external search engines too.)
> >>>
> >>> Another benefit is that when a user clicks on a label, the user is
> >>> presented with a list of similar articles. Much better than navigating
> a
> >>> big
> >>> hierarchy.
> >>>
> >>> Adding labels is easy. When you are viewing or editing a page on the
> >>> Tuscany wiki, you should see a small "Labels" text below the page view
> >>> and
> >>> info tabs. There will be either a list of labels or "(None)" if there
> are
> >>> no
> >>> labels. If you are logged into Confluence, you will get a small yellow
> >>> edit
> >>> text label as well. Click on this edit label to add existing tags or to
> >>> make
> >>> up new ones.
> >>>
> >>> I just went through a bunch of Tuscany pages and added a large set of
> >>> tags.
> >>> Ideas include: osgi, testing, presentations, data-bindings,
> web-services,
> >>> architecture, videos, etc. Please help tag our articles.
> >>
> >> I just tried a couple to see what happens. Do you know the tags get
> >> applied
> >> to the HTML?
> >>
> >
> > Good HTML pages will include meta tags such as "keywords" and
> "description"
> > to help search engines and web crawlers identify and categorize the web
> > page.
> >
> > Unfortunately the internal Confluence wiki pages seems to provide no meta
> > tags made from the page labels. On the other hand, the Confluence search
> > algorithm appears to make use of these labels heavily.
> >
> > The external pages do have meta tags for "Content-Type", but I have not
> seen
> > any for keywords. I have added a few more labels there, so let me check
> in a
> > day or so to see if they have been published and propagated externally.
> >
> > I am no Confluence expert, but perhaps someone knows if we can publish
> the
> > tags? Is there a publish option somewhere?
> >
> > --
> > Thanks, Dan Becker
> >
>
>
>
> --
> Luciano Resende
> Apache Tuscany, Apache PhotArk
> http://people.apache.org/~lresende <http://people.apache.org/%7Elresende>
> http://lresende.blogspot.com/
>
How much control do we have over the template? Can we pull the confluence
tags and insert them into the HTML so that Google is likely to find them in
one of the usual ways.
Simon
Re: Boosting Tuscany web presence - improving consumability
Posted by Luciano Resende <lu...@gmail.com>.
There is a template we use for exporting the confluence pages to html.
Let me look if I can make something that would add the confluence tags
to the pages, or at least add a fixed set of keywords to all tags.
On Tue, Nov 18, 2008 at 1:12 PM, Dan Becker <da...@gmail.com> wrote:
> Simon Laws wrote:
>>
>> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com>
>> wrote:
>>
>>> I noticed one of the best ways of boosting Confluence search results for
>>> Tuscany wiki pages is to tag the pages. Even the simplest, nearly-empty
>>> page
>>> with a single tag will show up higher in wiki search results than the
>>> most
>>> detailed, lengthy, important treatise without tags. Since Confluence
>>> searches span multiple Apache projects, it will be to Tuscany's benefit
>>> to
>>> show up higher in search results. (Hopefully these labels are added as
>>> meta
>>> tags for external search engines too.)
>>>
>>> Another benefit is that when a user clicks on a label, the user is
>>> presented with a list of similar articles. Much better than navigating a
>>> big
>>> hierarchy.
>>>
>>> Adding labels is easy. When you are viewing or editing a page on the
>>> Tuscany wiki, you should see a small "Labels" text below the page view
>>> and
>>> info tabs. There will be either a list of labels or "(None)" if there are
>>> no
>>> labels. If you are logged into Confluence, you will get a small yellow
>>> edit
>>> text label as well. Click on this edit label to add existing tags or to
>>> make
>>> up new ones.
>>>
>>> I just went through a bunch of Tuscany pages and added a large set of
>>> tags.
>>> Ideas include: osgi, testing, presentations, data-bindings, web-services,
>>> architecture, videos, etc. Please help tag our articles.
>>
>> I just tried a couple to see what happens. Do you know the tags get
>> applied
>> to the HTML?
>>
>
> Good HTML pages will include meta tags such as "keywords" and "description"
> to help search engines and web crawlers identify and categorize the web
> page.
>
> Unfortunately the internal Confluence wiki pages seems to provide no meta
> tags made from the page labels. On the other hand, the Confluence search
> algorithm appears to make use of these labels heavily.
>
> The external pages do have meta tags for "Content-Type", but I have not seen
> any for keywords. I have added a few more labels there, so let me check in a
> day or so to see if they have been published and propagated externally.
>
> I am no Confluence expert, but perhaps someone knows if we can publish the
> tags? Is there a publish option somewhere?
>
> --
> Thanks, Dan Becker
>
--
Luciano Resende
Apache Tuscany, Apache PhotArk
http://people.apache.org/~lresende
http://lresende.blogspot.com/
Re: Boosting Tuscany web presence - improving consumability
Posted by Dan Becker <da...@gmail.com>.
Simon Laws wrote:
> On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com> wrote:
>
>> I noticed one of the best ways of boosting Confluence search results for
>> Tuscany wiki pages is to tag the pages. Even the simplest, nearly-empty page
>> with a single tag will show up higher in wiki search results than the most
>> detailed, lengthy, important treatise without tags. Since Confluence
>> searches span multiple Apache projects, it will be to Tuscany's benefit to
>> show up higher in search results. (Hopefully these labels are added as meta
>> tags for external search engines too.)
>>
>> Another benefit is that when a user clicks on a label, the user is
>> presented with a list of similar articles. Much better than navigating a big
>> hierarchy.
>>
>> Adding labels is easy. When you are viewing or editing a page on the
>> Tuscany wiki, you should see a small "Labels" text below the page view and
>> info tabs. There will be either a list of labels or "(None)" if there are no
>> labels. If you are logged into Confluence, you will get a small yellow edit
>> text label as well. Click on this edit label to add existing tags or to make
>> up new ones.
>>
>> I just went through a bunch of Tuscany pages and added a large set of tags.
>> Ideas include: osgi, testing, presentations, data-bindings, web-services,
>> architecture, videos, etc. Please help tag our articles.
>
> I just tried a couple to see what happens. Do you know the tags get applied
> to the HTML?
>
Good HTML pages will include meta tags such as "keywords" and
"description" to help search engines and web crawlers identify and
categorize the web page.
Unfortunately the internal Confluence wiki pages seems to provide no
meta tags made from the page labels. On the other hand, the Confluence
search algorithm appears to make use of these labels heavily.
The external pages do have meta tags for "Content-Type", but I have not
seen any for keywords. I have added a few more labels there, so let me
check in a day or so to see if they have been published and propagated
externally.
I am no Confluence expert, but perhaps someone knows if we can publish
the tags? Is there a publish option somewhere?
--
Thanks, Dan Becker
Re: Boosting Tuscany web presence - improving consumability
Posted by Simon Laws <si...@googlemail.com>.
On Tue, Nov 18, 2008 at 8:35 PM, Dan Becker <da...@gmail.com> wrote:
> I noticed one of the best ways of boosting Confluence search results for
> Tuscany wiki pages is to tag the pages. Even the simplest, nearly-empty page
> with a single tag will show up higher in wiki search results than the most
> detailed, lengthy, important treatise without tags. Since Confluence
> searches span multiple Apache projects, it will be to Tuscany's benefit to
> show up higher in search results. (Hopefully these labels are added as meta
> tags for external search engines too.)
>
> Another benefit is that when a user clicks on a label, the user is
> presented with a list of similar articles. Much better than navigating a big
> hierarchy.
>
> Adding labels is easy. When you are viewing or editing a page on the
> Tuscany wiki, you should see a small "Labels" text below the page view and
> info tabs. There will be either a list of labels or "(None)" if there are no
> labels. If you are logged into Confluence, you will get a small yellow edit
> text label as well. Click on this edit label to add existing tags or to make
> up new ones.
>
> I just went through a bunch of Tuscany pages and added a large set of tags.
> Ideas include: osgi, testing, presentations, data-bindings, web-services,
> architecture, videos, etc. Please help tag our articles.
> --
> Thanks, Dan Becker
>
Hi Dan
I just tried a couple to see what happens. Do you know the tags get applied
to the HTML?
Simon