Asciidoctor :: Discussion

skipping reference to missing attribute

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

10 messages Options

halol

Feb 27, 2020; 9:54am

skipping reference to missing attribute

Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.

# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----

In this case, the output is:

asciidoctor: WARNING: skipping reference to missing attribute: shell_var

Thanks.

David Jencks

Feb 27, 2020; 2:57pm

Re: skipping reference to missing attribute

This works for me:

:attribute: attr

[source,shell,subs=attributes]
----
ATTR=asciidoctor

echo {attribute} $\{ATTR}
----

David Jencks

> On Feb 27, 2020, at 1:54 AM, halol [via Asciidoctor :: Discussion] <[hidden email]> wrote:
>
> Hello,
>
> Is there a way to process a document such as the one below, without getting a warning?
>
> The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
>
> # Test :attribute-missing: warn :ADOC_ATTR: asciidoctor [subs="attributes"] ---- SHELL_VAR="shell" echo {ADOC_ATTR} ${SHELL_VAR} ----
>
> In this case, the output is:
> asciidoctor: WARNING: skipping reference to missing attribute: shell_var
>
> Thanks.
>
> If you reply to this email, your message will be added to the discussion below:
> https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html
> To start a new topic under Asciidoctor :: Discussion, email [hidden email]
> To unsubscribe from Asciidoctor :: Discussion, click here.
> NAML

... [show rest of quote]

mojavelinux

Feb 27, 2020; 6:19pm

Re: skipping reference to missing attribute

Administrator

In reply to this post by halol

The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan

On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

David Jencks

Feb 27, 2020; 7:14pm

Re: skipping reference to missing attribute

I think the point is that he wants ${foo} to be the shell literal, not a (missing) asciidoc attribute reference. So escaping the ${ as $\{ prevents asciidoc from interpreting the { in ${ as the start of an attribute.

David Jencks

On Feb 27, 2020, at 10:19 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan
On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <<a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7691.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

mojavelinux

Feb 27, 2020; 7:17pm

Re: skipping reference to missing attribute

Administrator

Yes, both are valid options. You can either escape it or disable the warnings.

-Dan

On Thu, Feb 27, 2020, 12:14 David Jencks [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I think the point is that he wants ${foo} to be the shell literal, not a (missing) asciidoc attribute reference. So escaping the ${ as $\{ prevents asciidoc from interpreting the { in ${ as the start of an attribute.
David Jencks
On Feb 27, 2020, at 10:19 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan
On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <<a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7691.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7692.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

mojavelinux

Feb 27, 2020; 7:19pm

Re: skipping reference to missing attribute

Administrator

In reply to this post by David Jencks

Btw, never use subs=attributes

It should be subs=attributes+. Otherwise, special characters won't be escaped and it will produce broken HTML.

On Thu, Feb 27, 2020, 12:17 Dan Allen <[hidden email]> wrote:

Yes, both are valid options. You can either escape it or disable the warnings.

-Dan
On Thu, Feb 27, 2020, 12:14 David Jencks [via Asciidoctor :: Discussion] <[hidden email]> wrote:
I think the point is that he wants ${foo} to be the shell literal, not a (missing) asciidoc attribute reference. So escaping the ${ as $\{ prevents asciidoc from interpreting the { in ${ as the start of an attribute.
David Jencks
On Feb 27, 2020, at 10:19 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan
On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <<a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7691.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7692.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]

... [show rest of quote]

David Jencks

Feb 27, 2020; 7:26pm

Re: skipping reference to missing attribute

In reply to this post by mojavelinux

They have really different effects. Consider:

:ambiguous: asciidoctor

[source,shell,subs=attributes+]

----

ambiguous=shell

echo {ambiguous} ${ambiguous}

——

not that this is a good idea…. but what if in his example someone later edited the .adoc to define,

:SHELL_VAR: now an asciidoc attribute!

David Jencks

On Feb 27, 2020, at 11:17 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Yes, both are valid options. You can either escape it or disable the warnings.

-Dan
On Thu, Feb 27, 2020, 12:14 David Jencks [via Asciidoctor :: Discussion] <<a href="x-msg://43/user/SendEmail.jtp?type=node&node=7693&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
I think the point is that he wants ${foo} to be the shell literal, not a (missing) asciidoc attribute reference. So escaping the ${ as $\{ prevents asciidoc from interpreting the { in ${ as the start of an attribute.
David Jencks
On Feb 27, 2020, at 10:19 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan
On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <<a href="<a href="x-msg://41/user/SendEmail.jtp?type=node&amp;node=7691&amp;i=0" class="">x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email <a href="<a href="x-msg://41/user/SendEmail.jtp?type=node&amp;node=7691&amp;i=1" class="">x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7691.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7692.html

To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://43/user/SendEmail.jtp?type=node&node=7693&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7693.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

mojavelinux

Feb 27, 2020; 7:43pm

Re: skipping reference to missing attribute

Administrator

I agree they're different. I expect the writer to know which one is best for them. I'm just offering the options.

-Dan

On Thu, Feb 27, 2020 at 12:26 PM David Jencks [via Asciidoctor :: Discussion] <[hidden email]> wrote:

They have really different effects. Consider:

:ambiguous: asciidoctor

[source,shell,subs=attributes+]
----
ambiguous=shell

echo {ambiguous} ${ambiguous}
——

not that this is a good idea…. but what if in his example someone later edited the .adoc to define,

:SHELL_VAR: now an asciidoc attribute!
David Jencks
On Feb 27, 2020, at 11:17 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Yes, both are valid options. You can either escape it or disable the warnings.

-Dan
On Thu, Feb 27, 2020, 12:14 David Jencks [via Asciidoctor :: Discussion] <<a href="x-msg://43/user/SendEmail.jtp?type=node&node=7693&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
I think the point is that he wants ${foo} to be the shell literal, not a (missing) asciidoc attribute reference. So escaping the ${ as $\{ prevents asciidoc from interpreting the { in ${ as the start of an attribute.
David Jencks
On Feb 27, 2020, at 10:19 AM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The warning is controlled by the attribute-missing attribute. By default, the value is "skip", which produces no warning for a missing attribute (and leaves it as typed). To get a warning, you must set attribute-missing to "warn". So check your settings to see what value is being used and adjust accordingly.

See https://asciidoctor.org/docs/user-manual/#missing-attribute

Best,

-Dan
On Thu, Feb 27, 2020 at 2:54 AM halol [via Asciidoctor :: Discussion] <<a href="<a href="x-msg://41/user/SendEmail.jtp?type=node&amp;node=7691&amp;i=0" class="">x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=0" target="_top" rel="nofollow" link="external" class="">[hidden email]> wrote:
Hello,

Is there a way to process a document such as the one below, without getting a warning?

The difficulty here is to mix shell variables (using the ${var} notation is a requirement) with asciidoctor attributes in the same block. The final output is fine, but I am getting a lot of warnings and sorting out which ones matter (actually missing asciidoctor attributes) and which one don't (shell variables) is not always easy.
# Test

:attribute-missing: warn

:ADOC_ATTR:      asciidoctor

[subs="attributes"]
----
SHELL_VAR="shell"

echo {ADOC_ATTR} ${SHELL_VAR}
----
In this case, the output is:
asciidoctor: WARNING: skipping reference to missing attribute: shell_var
Thanks.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687.html

To start a new topic under Asciidoctor :: Discussion, email <a href="<a href="x-msg://41/user/SendEmail.jtp?type=node&amp;node=7691&amp;i=1" class="">x-msg://41/user/SendEmail.jtp?type=node&node=7691&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7691.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7692.html

To start a new topic under Asciidoctor :: Discussion, email <a href="x-msg://43/user/SendEmail.jtp?type=node&node=7693&i=1" target="_top" rel="nofollow" link="external" class="">[hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7693.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML
... [show rest of quote]
If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7695.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux

halol

Feb 28, 2020; 8:41am

Re: skipping reference to missing attribute

Thank you both for your replies.

Escaping the shell variable is indeed what I need, and I now feel a bit dumb for not thinking about it before. Specially since I have been struggling with the opposite problem: attributes being escaped when I don't want them to be.

For example:

:folder_name:  Path
[source,shell,subs=attributes+]
----
D:\Windows\{folder_name}
----

Which very obviously doesn't produce the expected results. That should have given me the solution to my current problem!

And I take good note of the comment regarding subs=attributes.

Thanks again.

David Jencks

Feb 28, 2020; 3:12pm

Re: skipping reference to missing attribute

In case you haven’t discovered this already….

:folder_name:  Path
[source,shell,subs=attributes+]
----
D:\Windows{backslash}{folder_name}
----

A.3. Predefined Attributes for Character Replacements

David Jencks

On Feb 28, 2020, at 12:41 AM, halol [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Thank you both for your replies.

Escaping the shell variable is indeed what I need, and I now feel a bit dumb for not thinking about it before. Specially since I have been struggling with the opposite problem: attributes being escaped when I don't want them to be.

For example:
:folder_name:  Path
[source,shell,subs=attributes+]
----
D:\Windows\{folder_name}
----
Which very obviously doesn't produce the expected results. That should have given me the solution to my current problem!

And I take good note of the comment regarding subs=attributes.

Thanks again.

If you reply to this email, your message will be added to the discussion below:
https://discuss.asciidoctor.org/skipping-reference-to-missing-attribute-tp7687p7700.html

To start a new topic under Asciidoctor :: Discussion, [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]