Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
  • Aug 22 18:05
    john-cj edited #3396
  • Aug 22 17:56
    john-cj edited #3396
  • Aug 22 17:55
    john-cj opened #3396
  • Aug 22 05:47
    mojavelinux labeled #3394
  • Aug 22 05:47
    mojavelinux labeled #3394
  • Aug 22 05:47
    mojavelinux milestoned #3394
  • Aug 22 05:47
    mojavelinux assigned #3394
  • Aug 22 05:46
    mojavelinux closed #3395
  • Aug 22 05:46
    mojavelinux closed #3394
  • Aug 20 23:08
    aerostitch opened #3395
  • Aug 20 22:08
    aerostitch opened #3394
  • Aug 20 20:37
    Mogztter synchronize #3305
  • Aug 20 20:09
    Mogztter synchronize #3305
  • Aug 18 18:28
    aerostitch closed #3393
  • Aug 18 16:26
    aerostitch opened #3393
  • Aug 18 13:19
    john-cj edited #3391
  • Aug 16 16:21
    Nathan-Furnal opened #3392
  • Aug 16 15:32
    john-cj edited #3391
  • Aug 16 15:32
    john-cj edited #3391
  • Aug 16 15:31
    john-cj edited #3391
Dan Allen
@mojavelinux

When just using [NOTE] I get this output

I think you are fooling yourself into thinking it is working

I'm just kind of getting the sense that you are making this harder than it needs to be
and what I mean by that is that you are trying to change too many variables at once, so you are ending up getting yourself twisted into knots
start with the simplest thing and get that working, then gradually enhance it
I would start by using the preprocessor to convert // REMARK content into an admonition paragraph. get that working first, then take the next step
Joseph Cayouette
@jcayouette
Ok sound advice, thanks
Daniel
@indero
Good Sunday.
I'm looking for adding classes to headings. In our case we have a DND Campaign, with bunch of important NPCs. The Idea was that the NPC's get an icon based on if they are: friendly, enemies, merchants etc. My idea was to solve this by adding classes to headings. Which then act as kind of a label. I'm not sure if solving this with classes is the best solution and would I need to write a plugin for asciidoctor to achieve that?
Abel Salgado Romero
@abelsromero
This seems a good case for roles(https://asciidoctor.org/docs/user-manual/#role). But I wasn't able to add them to the heading (h2, h3 element), but only to the whole section div. Not sure if this is on purpose
But in this case it make sense semantically, and you can even combine classes, with just
[.merchant.enemy]
=== NPC 1

[.merchant.friendly]
=== NPC 2
Dan Allen
@mojavelinux

@abelsromero you are correct about roles

But I wasn't able to add them to the heading (h2, h3 element), but only to the whole section div. Not sure if this is on purpose

yes, that's intentional. if we add it directly to the heading element, then you can't style the section. but since we add it to the section element, you can style either. the heading is styled used .sect1.rolename > h2 (and so forth)

it's one of those cases where it seems obvious to add it directly to the heading at first, but when you think about all the use cases, you realize it should be on the section container
Daniel
@indero
Cool thanks, sounds like a good and easy solution. I did not think about applying it to the section. :)
Joseph Cayouette
@jcayouette
@indero Hah! Neat implementation. :)
Joseph Cayouette
@jcayouette
Just wondering why text and a code block do not require a single line break between them and text and a list does:
This is a test
----
testing a code block
----

testing a list

* one
* two
* three
I know this has a good explanation, but it would be helpful to get a clear picture for teaching others why this is the case.
Dan Allen
@mojavelinux
because delimited blocks have the highest precedence in the syntax. simple as that
there can be no confusion about where they are, so they are the most lenient about blank lines
but I strongly discourage putting content directly against them for readability and consistency
Joseph Cayouette
@jcayouette
OK great thank you.
Dan Allen
@mojavelinux
it's extremely easy to confuse a list marker with a wrapped character in a paragraph, which is why the blank line is required
Joseph Cayouette
@jcayouette
Ah right, like bold/strong for example.
Dan Allen
@mojavelinux
actually, more like saying "you multiply two numbers by putting a * between them like in this sentence."
if the wrap occurs right before the asterisk, it would become a list
and you would be amazed at how common this is (as I've often had to deal with it when migrating content)
not that marker specifically, but there are many list markers
the more common would be
"When we scanned the room, we counted about 20. Most of them were there for the food."
if the wrap happened right after "about", the next line would end up being a list item
and then give a very strange and unexpected warning that the list counter is out of sequence.
Joseph Cayouette
@jcayouette
yikes, crazy
I am still working it out with colleagues but which of the following two examples looks cleaner, thoughts?
To do foo, use teh [command]``foo`` command:
----
foo --bar
----

To do bat, use the [command]``bat`` command:
----
bat --bar
----
Anything wrong with this?
We are throwing together a BP guide for our contribs
To do foo, use teh [command]``foo`` command:

----
foo --bar
----

To do bat, use the [command]``bat`` command:

----
bat --bar
----
Ugh semantics.
Dan Allen
@mojavelinux
the latter is the preferred syntax
Joseph Cayouette
@jcayouette
@mojavelinux Thanks we agreed on sticking with your recommendation.
Dan Allen
@mojavelinux
:+1:
Pi3r
@PierreR
Is there a way to style/render highlight (as with the markcss style )(for instance #foo#) in pdf with asciidoctor-pdf ?
Pi3r
@PierreR
I have been trying something like this in my style.yml but without success:
role:
  mark:
    font-color: #ff0000
Guillaume Grossetie
@Mogztter
I think you need to declare an explicit role name
[.mark]+foo+
Dan Allen
@mojavelinux
correct
(though we should probably support the highlighting mark now that Asciidoctor PDF supports inline background colors).
file an issue
Joseph Cayouette
@jcayouette
Is there a way to create a build log with asciidoctor-pdf?
I would like to add the final output of each pdf to a single file, then echo it at the end of the build for clarity.
Pi3r
@PierreR
Just hit this issue asciidoctor/asciidoctor-pdf#857 ;-)