public inbox archive for pandoc-discuss@googlegroups.com
 help / color / mirror / Atom feed
* HTML Ids and class
@ 2020-06-27 18:24 Lloyd R. prentice
       [not found] ` <decefc7e-1ef2-4567-9fe6-24e2669094e1-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
  0 siblings, 1 reply; 6+ messages in thread
From: Lloyd R. prentice @ 2020-06-27 18:24 UTC (permalink / raw)
  To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw

[-- Attachment #1: Type: text/plain, Size: 1482 bytes --]

Hello,

With much digging into the docs I discovered how to assign id and class attributes to HTML divs:

::::: {#myid .myclass}
:::::

But this method fails for h1...6 and p. When I specified:

## The Craft of Writing

### Fiction at its best...

I got this:

<h2 id="the-craft-of-writing">The Craft of Writing</h2>
<h3 id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction at its best delivers insight and delight. Nonfiction delivers news. Insight, delight, and news are all in the mind of the reader. The writer must know the mind of the reader.</h3>

Rather than h3, I would have preferred to use a class-styled paragraph but I have not found a way to do it. So I used h3. But, as we can see, h3 assigns rather ridiculous id and class values. No harm in my case, but could be in other cases.

Did I miss something in the docs? Or is this something that can and should be fixed?

Many thanks,

LRP

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com.

[-- Attachment #2: Type: text/html, Size: 2269 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: HTML Ids and class
       [not found] ` <decefc7e-1ef2-4567-9fe6-24e2669094e1-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
@ 2020-06-27 18:51   ` BPJ
       [not found]     ` <CADAJKhA+wrsNxWN7FiHmPQ-VA5fsA+A_tmnoyRBt7=cG6cRvhQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
  0 siblings, 1 reply; 6+ messages in thread
From: BPJ @ 2020-06-27 18:51 UTC (permalink / raw)
  To: pandoc-discuss

[-- Attachment #1: Type: text/plain, Size: 2964 bytes --]

It may help to read the manual:

<https://pandoc.org/MANUAL.html#heading-identifiers>

<https://pandoc.org/MANUAL.html#extension-auto_identifiers>

<https://pandoc.org/MANUAL.html#extension-link_attributes>

<https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>

<https://pandoc.org/MANUAL.html#extension-inline_code_attributes>

<https://pandoc.org/MANUAL.html#divs-and-spans>

IOW attributes are supported only for headings, divs, spans, links, images
and code.  For all other elements you have to wrap them in a div (if they
are block elements) or a span (if they are inline elements) and use
compound CSS selectors like `div.foo p`.

-- 
Better --help|less than helpless

Den lör 27 juni 2020 20:25Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:

> Hello,
>
> With much digging into the docs I discovered how to assign id and class
> attributes to HTML divs:
>
> ::::: {#myid .myclass}
> :::::
>
> But this method fails for h1...6 and p. When I specified:
>
> ## The Craft of Writing
>
> ### Fiction at its best...
>
> I got this:
>
> <h2 id="the-craft-of-writing">The Craft of Writing</h2>
> <h3
> id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction
> at its best delivers insight and delight. Nonfiction delivers news.
> Insight, delight, and news are all in the mind of the reader. The writer
> must know the mind of the reader.</h3>
>
> Rather than h3, I would have preferred to use a class-styled paragraph but
> I have not found a way to do it. So I used h3. But, as we can see, h3
> assigns rather ridiculous id and class values. No harm in my case, but
> could be in other cases.
>
> Did I miss something in the docs? Or is this something that can and should
> be fixed?
>
> Many thanks,
>
> LRP
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 4891 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: HTML Ids and class
       [not found]     ` <CADAJKhA+wrsNxWN7FiHmPQ-VA5fsA+A_tmnoyRBt7=cG6cRvhQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
@ 2020-06-27 19:04       ` Lloyd R. Prentice
       [not found]         ` <1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org>
  0 siblings, 1 reply; 6+ messages in thread
From: Lloyd R. Prentice @ 2020-06-27 19:04 UTC (permalink / raw)
  To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw

[-- Attachment #1: Type: text/plain, Size: 3459 bytes --]

Ah, my aging eyes missed that.

Many thanks,

LRP


Sent from my iPad

> On Jun 27, 2020, at 2:52 PM, BPJ <bpj-J3H7GcXPSITLoDKTGw+V6w@public.gmane.org> wrote:
> 
> 
> It may help to read the manual:
> 
> <https://pandoc.org/MANUAL.html#heading-identifiers>
> 
> <https://pandoc.org/MANUAL.html#extension-auto_identifiers>
> 
> <https://pandoc.org/MANUAL.html#extension-link_attributes>
> 
> <https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>
> 
> <https://pandoc.org/MANUAL.html#extension-inline_code_attributes>
> 
> <https://pandoc.org/MANUAL.html#divs-and-spans>
> 
> IOW attributes are supported only for headings, divs, spans, links, images and code.  For all other elements you have to wrap them in a div (if they are block elements) or a span (if they are inline elements) and use compound CSS selectors like `div.foo p`.
> 
> -- 
> Better --help|less than helpless
> 
> Den lör 27 juni 2020 20:25Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>> Hello,
>> 
>> With much digging into the docs I discovered how to assign id and class attributes to HTML divs:
>> 
>> ::::: {#myid .myclass}
>> :::::
>> 
>> But this method fails for h1...6 and p. When I specified:
>> 
>> ## The Craft of Writing
>> 
>> ### Fiction at its best...
>> 
>> I got this:
>> 
>> <h2 id="the-craft-of-writing">The Craft of Writing</h2>
>> <h3 id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction at its best delivers insight and delight. Nonfiction delivers news. Insight, delight, and news are all in the mind of the reader. The writer must know the mind of the reader.</h3>
>> 
>> Rather than h3, I would have preferred to use a class-styled paragraph but I have not found a way to do it. So I used h3. But, as we can see, h3 assigns rather ridiculous id and class values. No harm in my case, but  could be in other cases.
>> 
>> Did I miss something in the docs? Or is this something that can and should be fixed?
>> 
>> Many thanks,
>> 
>> LRP
>> 
>> -- 
>> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com.
> 
> -- 
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com.

[-- Attachment #2: Type: text/html, Size: 6045 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: HTML Ids and class
       [not found]         ` <1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org>
@ 2020-06-27 20:13           ` BPJ
       [not found]             ` <CADAJKhAKw2oy3Ns+diKCWc1Suo_TYvOvG3NvK+YkQ68RdV+EhA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
  0 siblings, 1 reply; 6+ messages in thread
From: BPJ @ 2020-06-27 20:13 UTC (permalink / raw)
  To: pandoc-discuss

[-- Attachment #1: Type: text/plain, Size: 4981 bytes --]

You're welcome. I realized that I would probably not have found all that
without knowing what to look for. The manual should probably have an
"attributes" section with a summary of how attributes work and which
elements they apply to, and links to those other sections. I wonder if a PR
for such a section would be welcome.

/BPJ -- not as short-sighted as I used to be any more either! :)


-- 
Better --help|less than helpless

Den lör 27 juni 2020 21:04Lloyd R. Prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:

> Ah, my aging eyes missed that.
>
> Many thanks,
>
> LRP
>
>
> Sent from my iPad
>
> On Jun 27, 2020, at 2:52 PM, BPJ <bpj-J3H7GcXPSITLoDKTGw+V6w@public.gmane.org> wrote:
>
> 
> It may help to read the manual:
>
> <https://pandoc.org/MANUAL.html#heading-identifiers>
>
> <https://pandoc.org/MANUAL.html#extension-auto_identifiers>
>
> <https://pandoc.org/MANUAL.html#extension-link_attributes>
>
> <https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>
>
> <https://pandoc.org/MANUAL.html#extension-inline_code_attributes>
>
> <https://pandoc.org/MANUAL.html#divs-and-spans>
>
> IOW attributes are supported only for headings, divs, spans, links, images
> and code.  For all other elements you have to wrap them in a div (if they
> are block elements) or a span (if they are inline elements) and use
> compound CSS selectors like `div.foo p`.
>
> --
> Better --help|less than helpless
>
> Den lör 27 juni 2020 20:25Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>
>> Hello,
>>
>> With much digging into the docs I discovered how to assign id and class
>> attributes to HTML divs:
>>
>> ::::: {#myid .myclass}
>> :::::
>>
>> But this method fails for h1...6 and p. When I specified:
>>
>> ## The Craft of Writing
>>
>> ### Fiction at its best...
>>
>> I got this:
>>
>> <h2 id="the-craft-of-writing">The Craft of Writing</h2>
>> <h3
>> id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction
>> at its best delivers insight and delight. Nonfiction delivers news.
>> Insight, delight, and news are all in the mind of the reader. The writer
>> must know the mind of the reader.</h3>
>>
>> Rather than h3, I would have preferred to use a class-styled paragraph
>> but I have not found a way to do it. So I used h3. But, as we can see, h3
>> assigns rather ridiculous id and class values. No harm in my case, but
>> could be in other cases.
>>
>> Did I miss something in the docs? Or is this something that can and
>> should be fixed?
>>
>> Many thanks,
>>
>> LRP
>>
>> --
>> You received this message because you are subscribed to the Google Groups
>> "pandoc-discuss" group.
>> To unsubscribe from this group and stop receiving emails from it, send an
>> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>> To view this discussion on the web visit
>> https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com
>> <https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com?utm_medium=email&utm_source=footer>
>> .
>>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com?utm_medium=email&utm_source=footer>
> .
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com
> <https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhAKw2oy3Ns%2BdiKCWc1Suo_TYvOvG3NvK%2BYkQ68RdV%2BEhA%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 8104 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: HTML Ids and class
       [not found]             ` <CADAJKhAKw2oy3Ns+diKCWc1Suo_TYvOvG3NvK+YkQ68RdV+EhA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
@ 2020-06-27 20:58               ` Lloyd R. prentice
       [not found]                 ` <d74ab748-2480-4fc1-bb86-492b5856fcdb-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
  0 siblings, 1 reply; 6+ messages in thread
From: Lloyd R. prentice @ 2020-06-27 20:58 UTC (permalink / raw)
  To: pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw

[-- Attachment #1: Type: text/plain, Size: 6255 bytes --]

Hi BPJ,

The Pandoc community deserves hearty thanks for both the code and the extensive documentation. But many important details do seem to get lost in the User Guide. In my experience an index or more detailed sidebar links would help enormously

When I have a question I often find myself by-passing the Guide and seeking answers elsewhere on the web simply because I don't know where to find the answer. 

But I much appreciate what we do have and am working hard to make it relevant to my web development work.

Thanks all,

LRP. 

On Sat, Jun 27, 2020, at 4:13 PM, BPJ wrote:
> You're welcome. I realized that I would probably not have found all that without knowing what to look for. The manual should probably have an "attributes" section with a summary of how attributes work and which elements they apply to, and links to those other sections. I wonder if a PR for such a section would be welcome.
> 
> /BPJ -- not as short-sighted as I used to be any more either! :)
> 
> 
> -- 
> Better --help|less than helpless
> 
> Den lör 27 juni 2020 21:04Lloyd R. Prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>> Ah, my aging eyes missed that.
>> 
>> Many thanks,
>> 
>> LRP
>> 
>> 
>> Sent from my iPad
>> 
>>> On Jun 27, 2020, at 2:52 PM, BPJ <bpj-J3H7GcXPSITLoDKTGw+V6w@public.gmane.org> wrote:
>>> 
>>> It may help to read the manual:
>>> 
>>> <https://pandoc.org/MANUAL.html#heading-identifiers>
>>> 
>>> <https://pandoc.org/MANUAL.html#extension-auto_identifiers>
>>> 
>>> <https://pandoc.org/MANUAL.html#extension-link_attributes>
>>> 
>>> <https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>
>>> 
>>> <https://pandoc.org/MANUAL.html#extension-inline_code_attributes>
>>> 
>>> <https://pandoc.org/MANUAL.html#divs-and-spans>
>>> 
>>> IOW attributes are supported only for headings, divs, spans, links, images and code. For all other elements you have to wrap them in a div (if they are block elements) or a span (if they are inline elements) and use compound CSS selectors like `div.foo p`.
>>> 
>>> -- 
>>> Better --help|less than helpless
>>> 
>>> Den lör 27 juni 2020 20:25Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>>>> __
>>>> Hello,
>>>> 
>>>> With much digging into the docs I discovered how to assign id and class attributes to HTML divs:
>>>> 
>>>> ::::: {#myid .myclass}
>>>> :::::
>>>> 
>>>> But this method fails for h1...6 and p. When I specified:
>>>> 
>>>> ## The Craft of Writing
>>>> 
>>>> ### Fiction at its best...
>>>> 
>>>> I got this:
>>>> 
>>>> <h2 id="the-craft-of-writing">The Craft of Writing</h2>
>>>> <h3 id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction at its best delivers insight and delight. Nonfiction delivers news. Insight, delight, and news are all in the mind of the reader. The writer must know the mind of the reader.</h3>
>>>> 
>>>> Rather than h3, I would have preferred to use a class-styled paragraph but I have not found a way to do it. So I used h3. But, as we can see, h3 assigns rather ridiculous id and class values. No harm in my case, but could be in other cases.
>>>> 
>>>> Did I miss something in the docs? Or is this something that can and should be fixed?
>>>> 
>>>> Many thanks,
>>>> 
>>>> LRP
>>>> 
>>>> 

>>>> --
>>>>  You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>>>>  To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>>>>  To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com <https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com?utm_medium=email&utm_source=footer>.
>>> 

>>> --
>>>  You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>>>  To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>>>  To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com <https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com?utm_medium=email&utm_source=footer>.
>> 

>> --
>>  You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>>  To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>>  To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com <https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com?utm_medium=email&utm_source=footer>.
> 

> --
>  You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
>  To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>  To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhAKw2oy3Ns%2BdiKCWc1Suo_TYvOvG3NvK%2BYkQ68RdV%2BEhA%40mail.gmail.com <https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhAKw2oy3Ns%2BdiKCWc1Suo_TYvOvG3NvK%2BYkQ68RdV%2BEhA%40mail.gmail.com?utm_medium=email&utm_source=footer>.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d74ab748-2480-4fc1-bb86-492b5856fcdb%40www.fastmail.com.

[-- Attachment #2: Type: text/html, Size: 10226 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: HTML Ids and class
       [not found]                 ` <d74ab748-2480-4fc1-bb86-492b5856fcdb-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
@ 2020-06-27 21:46                   ` BPJ
  0 siblings, 0 replies; 6+ messages in thread
From: BPJ @ 2020-06-27 21:46 UTC (permalink / raw)
  To: pandoc-discuss

[-- Attachment #1: Type: text/plain, Size: 8062 bytes --]

The table of contents on the manual page could probably go deeper.  Indices
on the other hand are tricky beasts. Of course one could wrap words and
phrases which should go into the index with in a span with class 'index'
and then use a filter to extract them and build an index, but here is the
snag: to have the spans work as anchors the filter would have to assign a
unique id to each — say something like 'index-N' where N is a serial number
— and those automatically assigned ids will not be permanent, but will
change as new terms are marked for indexing. That's not a problem as long
as people use the index as intended and don't try to rely on those ids by
linking to those anchors.  Unfortunately you can be pretty sure that people
do try to link to those anchors and much confusion will ensue. Notes of
warning are not of much help, because people don't read/heed them. Trying
to hard code those ids and keep checking for duplicates just deepens the
mess.  Been there, done that (before Pandoc, traversing HTML doc structures
with a Perl script, but the problems are the same).


-- 
Better --help|less than helpless

Den lör 27 juni 2020 23:00Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:

> Hi BPJ,
>
> The Pandoc community deserves hearty thanks for both the code and the
> extensive documentation.  But many important details do seem to get lost in
> the User Guide. In my experience an index or more detailed sidebar links
> would help enormously
>
> When I have a question I often find myself by-passing the Guide and
> seeking answers elsewhere on the web simply because I don't know where to
> find the answer.
>
> But I much appreciate what we do have and am working hard to make it
> relevant to my web development work.
>
> Thanks all,
>
> LRP.
>
> On Sat, Jun 27, 2020, at 4:13 PM, BPJ wrote:
>
> You're welcome. I realized that I would probably not have found all that
> without knowing what to look for. The manual should probably have an
> "attributes" section with a summary of how attributes work and which
> elements they apply to, and links to those other sections. I wonder if a PR
> for such a section would be welcome.
>
> /BPJ -- not as short-sighted as I used to be any more either! :)
>
>
> --
> Better --help|less than helpless
>
> Den lör 27 juni 2020 21:04Lloyd R. Prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>
> Ah, my aging eyes missed that.
>
> Many thanks,
>
> LRP
>
>
> Sent from my iPad
>
> On Jun 27, 2020, at 2:52 PM, BPJ <bpj-J3H7GcXPSITLoDKTGw+V6w@public.gmane.org> wrote:
>
> 
> It may help to read the manual:
>
> <https://pandoc.org/MANUAL.html#heading-identifiers>
>
> <https://pandoc.org/MANUAL.html#extension-auto_identifiers>
>
> <https://pandoc.org/MANUAL.html#extension-link_attributes>
>
> <https://pandoc.org/MANUAL.html#extension-fenced_code_attributes>
>
> <https://pandoc.org/MANUAL.html#extension-inline_code_attributes>
>
> <https://pandoc.org/MANUAL.html#divs-and-spans>
>
> IOW attributes are supported only for headings, divs, spans, links, images
> and code.  For all other elements you have to wrap them in a div (if they
> are block elements) or a span (if they are inline elements) and use
> compound CSS selectors like `div.foo p`.
>
> --
> Better --help|less than helpless
>
> Den lör 27 juni 2020 20:25Lloyd R. prentice <lloyd-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org> skrev:
>
>
> Hello,
>
> With much digging into the docs I discovered how to assign id and class
> attributes to HTML divs:
>
> ::::: {#myid .myclass}
> :::::
>
> But this method fails for h1...6 and p. When I specified:
>
> ## The Craft of Writing
>
> ### Fiction at its best...
>
> I got this:
>
> <h2 id="the-craft-of-writing">The Craft of Writing</h2>
> <h3
> id="fiction-at-its-best-delivers-insight-and-delight.-nonfiction-delivers-news.-insight-delight-and-news-are-all-in-the-mind-of-the-reader.-the-writer-must-know-the-mind-of-the-reader.">Fiction
> at its best delivers insight and delight. Nonfiction delivers news.
> Insight, delight, and news are all in the mind of the reader. The writer
> must know the mind of the reader.</h3>
>
> Rather than h3, I would have preferred to use a class-styled paragraph but
> I have not found a way to do it. So I used h3. But, as we can see, h3
> assigns rather ridiculous id and class values. No harm in my case, but
> could be in other cases.
>
> Did I miss something in the docs? Or is this something that can and should
> be fixed?
>
> Many thanks,
>
> LRP
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/decefc7e-1ef2-4567-9fe6-24e2669094e1%40www.fastmail.com?utm_medium=email&utm_source=footer>
> .
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA%2BwrsNxWN7FiHmPQ-VA5fsA%2BA_tmnoyRBt7%3DcG6cRvhQ%40mail.gmail.com?utm_medium=email&utm_source=footer>
> .
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com
> <https://groups.google.com/d/msgid/pandoc-discuss/1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31%40writersglen.com?utm_medium=email&utm_source=footer>
> .
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhAKw2oy3Ns%2BdiKCWc1Suo_TYvOvG3NvK%2BYkQ68RdV%2BEhA%40mail.gmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhAKw2oy3Ns%2BdiKCWc1Suo_TYvOvG3NvK%2BYkQ68RdV%2BEhA%40mail.gmail.com?utm_medium=email&utm_source=footer>
> .
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/d74ab748-2480-4fc1-bb86-492b5856fcdb%40www.fastmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/d74ab748-2480-4fc1-bb86-492b5856fcdb%40www.fastmail.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhB-P4CXQnkzvDvVTenFvejA27i4v_r8x-HJSmQJ%2BzkX2w%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 12694 bytes --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2020-06-27 21:46 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-27 18:24 HTML Ids and class Lloyd R. prentice
     [not found] ` <decefc7e-1ef2-4567-9fe6-24e2669094e1-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
2020-06-27 18:51   ` BPJ
     [not found]     ` <CADAJKhA+wrsNxWN7FiHmPQ-VA5fsA+A_tmnoyRBt7=cG6cRvhQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2020-06-27 19:04       ` Lloyd R. Prentice
     [not found]         ` <1CC9DBD2-4FD2-4976-B61A-74FFDD8E7D31-l7gIAb2iU4jcM+WK4BI3xw@public.gmane.org>
2020-06-27 20:13           ` BPJ
     [not found]             ` <CADAJKhAKw2oy3Ns+diKCWc1Suo_TYvOvG3NvK+YkQ68RdV+EhA-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2020-06-27 20:58               ` Lloyd R. prentice
     [not found]                 ` <d74ab748-2480-4fc1-bb86-492b5856fcdb-jFIJ+Wc5/Vo7lZ9V/NTDHw@public.gmane.org>
2020-06-27 21:46                   ` BPJ

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).