|
|
|
date: Mon, 10 Dec 2007 09:28:28 -0500,
group: microsoft.public.vstudio.helpauthoring
back
RE: MAML
Hi Rick,
you are right - a confusing time for technical writers authoring Microsoft
Windows OS based help topics at this stage.
HTMLHelp 1. x is the current help system since Windows 98. I recommend you
furthermore to use this help system for application help. You are supported
by Visual Studio.net and many other tools when developing help systems based
on HTMLHelp (*.CHM).
You know - Microsoft Windows Vista, formerly codenamed "Longhorn", was
released in 2006/2007.
AP Help 1.0 is is based on AML (Assistance Markup Language (formerly: MAML)
and shipped with Windows Vista (Jan 30 th 2007 was official launch). Only
Microsoft, Original Equipment Manufacturers (OEM) and corporate users will be
able to customize this help content for the operating system and OEM help.
AP Help 2.x is *not* available yet. Microsoft no longer have immediate plans
to release a public version of AP Help. So, Microsoft has not decided if it
will be an assistance platform for third-party vendors or another
Microsoft-only platform. However there is an AP Help SDK for OEMs which is
part of the Business Desktop Deployment 2007 download.
Microsft Windows Vista online Help is using Assistance Markup Language (AML)
and XSLT. I played with some VB2005 code to call the Vista help pane by
knowledge of the Windows Vista operating system help topic ID from an
application.
The Sandcastle - October 2007 Community Technology Preview (CTP) is using
some AML ("conceptual"). http://tinyurl.com/n8u5p
But again - there isn't a public version of AP Help.
I think following maybe interesting for you (read Part II carefully)
(1) Migrating from HTML to XHTML and XML - Part I
http://www.winwriters.com/articles/migrate/index.html
(2) Migrating from HTML to XHTML and XML - Part II
http://www.writersua.com/articles/migrate/part2.htm
(3) Help Authoring Tools supporting web-based help
see: http://hat-matrix.com/
--
HTH
Ulrich Kulle
Microsoft MVP - Windows Help
**********************
http://www.help-info.de
**********************
"user@domain.invalid" wrote:
> I want to suggest to a group that we use a help standard
> for developing a website whose main purpose is to serve as help for
> various applications. The Microsoft help philosophy of
> being context sensitive, guiding the user, and being 'just in time',
> and 'just enough' really appeals to me.
> But -- as far as I can tell -- and I am not really sure, as most
> documents seem to be several years old -- the MAML seems to have fallen
> by the wayside.
>
> Is it true that HTML help is the latest standard again for windows help?
> Will MAML rise again?
date: Tue, 11 Dec 2007 04:14:00 -0800
author: Ulrich Kulle [MVP] infoREMOVE##
Re: MAML
Thanks, Ulrich.
I actually had in mind using AML or something like it for the
help system for a website, not for a windows application -- the other
candidates, which are now rising in applicability, are the
eclipse help system, DITA, and topic maps.
I wish someone would update this blog:
http://blogs.msdn.com/apblog/
as it is very misleading. Thanks for the addition references.
The two articles about converting from html to xhtml, and then
xml are useful. I think, though, that the question of character
sets is kind of glossed over -- if you have a valid xhtml file,
(in part 1, after "During the second pass, the basic classes were
replaced with semantic classes (and a minor change was made to the
structure of the file)." )
as shown, its character set is UTF-8, but when the
file becomes 'Sample XML file'
its character set is now declared to be ISO-8859-1, as if simply
changing the encoding on the xml PI will change the encoding of the file.
Rick
Rick
Ulrich Kulle [MVP] wrote:
> Hi Rick,
>
> you are right - a confusing time for technical writers authoring Microsoft
> Windows OS based help topics at this stage.
>
> HTMLHelp 1. x is the current help system since Windows 98. I recommend you
> furthermore to use this help system for application help. You are supported
> by Visual Studio.net and many other tools when developing help systems based
> on HTMLHelp (*.CHM).
>
> You know - Microsoft Windows Vista, formerly codenamed "Longhorn", was
> released in 2006/2007.
>
> AP Help 1.0 is is based on AML (Assistance Markup Language (formerly: MAML)
> and shipped with Windows Vista (Jan 30 th 2007 was official launch). Only
> Microsoft, Original Equipment Manufacturers (OEM) and corporate users will be
> able to customize this help content for the operating system and OEM help.
>
> AP Help 2.x is *not* available yet. Microsoft no longer have immediate plans
> to release a public version of AP Help. So, Microsoft has not decided if it
> will be an assistance platform for third-party vendors or another
> Microsoft-only platform. However there is an AP Help SDK for OEMs which is
> part of the Business Desktop Deployment 2007 download.
>
> Microsft Windows Vista online Help is using Assistance Markup Language (AML)
> and XSLT. I played with some VB2005 code to call the Vista help pane by
> knowledge of the Windows Vista operating system help topic ID from an
> application.
>
> The Sandcastle - October 2007 Community Technology Preview (CTP) is using
> some AML ("conceptual"). http://tinyurl.com/n8u5p
>
> But again - there isn't a public version of AP Help.
>
> I think following maybe interesting for you (read Part II carefully)
> (1) Migrating from HTML to XHTML and XML - Part I
> http://www.winwriters.com/articles/migrate/index.html
> (2) Migrating from HTML to XHTML and XML - Part II
> http://www.writersua.com/articles/migrate/part2.htm
> (3) Help Authoring Tools supporting web-based help
> see: http://hat-matrix.com/
>
date: Wed, 12 Dec 2007 09:21:19 -0500
author: lid
Re: MAML
God has been very wonderful there; not much, if
any thing, short of what it has been here, in proportion to the size of
the place. About the same time, it began to break forth in the west part
of Suffield (where it also has been very great), and soon spread into
all parts of the town. It appeared at Sunderland, and soon overspread
the town: and I believe was, for a season, not less remarkable than it
was here. About the same time it began to appear in a part of Deerfield,
called Green River, and afterwards filled the town, and there has been a
glorious work there. It began also to be manifest, in the south part of
Hatfield, in a place call the Hill, and the whole town, in the second
week in April, seemed to be seized, as it were at once, with concern
about the things of religion; and the work of God has been great there.
There has been also a very general awakening at West-Springfield, and
Long Meadow; and in Enfield there was for a time a pretty general
concern amongst some who before had been very loose persons. About the
same time that this appeared at Enfield, the Rev. Mr. Bull, of
Westfield, informed me, that there had been a great alteration there,
and that more had been done in one week, than in seven years before.
Something of this work likewise appeared in the first precinct in
Springfield, principally in the north and south extremes of the parish.
And in Hadley old town, there gradually appeared so much of a work of
God on souls, as at another time would have been thought worthy of much
notice. For a short time there was also a very great and general
concern, of the like nature, at Northfield. And wherever this concern
appeared, it seemed not to be in vain: but in every place God brought
saving blessings with Him, and His word attended with His Spirit (as we
have all reason to think) returned not void. It might well be said at
that time, in all parts of the county, Who are these that fly as a
cloud, and as doves to
date: Thu, 24 Jan 2008 20:11:17 GMT
author: lid
we compensate the central cost
and
willingness to save sinners; but some have their thoughts more
especially fixed on God, in some of His sweet and glorious attributes
manifested in the gospel, and shining forth in the face of Christ. Some
view the all-sufficiency of the mercy and grace of God; some, chiefly
the infinite power of God, and His ability to save them, and to do all
things for them; and some look most at the truth and faithfulness of
God. In some, the truth and certainty of the gospel in general is the
first joyful discovery they have; in others, the certain truth of some
particular promises; in some, the grace and sincerity of God in His
invitations, very commonly in some particular invitation in the mind,
and it now appears real to them that God does indeed invite them. Some
are struck with the glory and wonderfulness of the dying love of Christ;
and some with the sufficiency and preciousness of His blood, as offered
to make an atonement for sin; and others with the value and glory of His
obedience and righteousness. In some the excellency and loveliness of
Christ, chiefly engages their thoughts; in some His divinity, that He is
indeed the Son of the living God; and in others, the excellency of the
way of salvation by Christ, and the suitableness of it to their
necessities.
Some have an apprehension of these things so given, that it seems more
natural to them to express it by sight or discovery, others think what
they experience is better expressed by the realizing conviction, or a
lively or feeling sense of heart; meaning, as I suppose, no other
difference but what is merely circumstantial or gradual.
There is, often, in the mind, some particular text of Scripture, holding
forth some evangelical ground of consolation; sometimes a multitude of
texts, gracious invitations and promises flowing in one after another,
filling the soul more and more with comfort and satisfaction. Comfort is
first
date: Thu, 24 Jan 2008 20:41:14 GMT
author: lid
|
|
