gmane.text.formats.asciidoc

CSS

Pau Garcia i Quiles — 2012-05-22T23:24:40

Hi,

Is it possible to use a theme without installing it?

I. e. something like asciidoc --theme=./mytheme/mytheme.css

Thank you

Re: A few issues with asciidoc

Lex Trotman — 2012-05-21T13:38:25

Your image shows single quotes ' not backtick ` ?  The particular font has
given them a bit of a forward lean though.



Different font.



a2x -v prints the xmllint error novel (well some of the messages are the
size of war and peace, thats why they are not printed by default)



HTML is generally less picky than docbook so thats not a surprise.

Cheers
Lex

A few issues with asciidoc

Pete Muir — 2012-05-21T08:34:18

Hi

We've encountered a few issues with asciidoc, happy to report them in an issue tracker if appropriate:

1) When processed to a PDF, single quotes in a sql statement are altered to back ticks

[source,sql]
---------------------------------------------------------------------------------------------------------
insert into Event (id, name, description, major, picture, version) values (1, 
'Shane''s Sock Puppets',
'This critically acclaimed masterpiece...',
true,
'http://dl.dropbox.com/u/65660684/640px-Carnival_Puppets.jpg',
1);
---------------------------------------------------------------------------------------------------------

gives 



The HTML output is fine though (single quotes rendered).

Obviously now no longer valid SQL!

2) If a duplicate id is used (e.g. for an image), a2x doesn't report the output from xmllint very well. Also occurs if you have an invalid character in your source, e.g. a CTRL-Z. It gives

a2x: ERROR: xmllint --nonet --noout --valid /Users/burr/code/burrsutter/ticket-monster

Re: Is there any way to use callouts within a table?

Lex Trotman — 2012-05-20T06:03:11

[...]

This works for me

blah
====
:tabledef-default.subs: normal,callouts

|====
|blah |blah <1>
|blah |blah <2>
|====

<1> blah
<2> blah

cheers
Lex

Re: Is there any way to use callouts within a table?

davide.cavestro — 2012-05-17T15:58:56


Many thanks Lex.

I've shamelessly tried (with no luck) a bunch of combinations for
configuration file entries, among with the following:

[tabledef-default]
presubs=callouts
postsubs=callouts

[miscellaneous]
subsnormal=callouts
subsverbatim=callouts

Maybe it's time to budget a more in-depth knowledge of asciidoc
processing and configuration :-)

Cheers
Davide

Re: Is there any way to use callouts within a table?

Lex Trotman — 2012-05-17T13:47:07

Hi,

From the user guide "By default callout marks are confined to
LiteralParagraphs, LiteralBlocks and ListingBlocks (although this is a
configuration file option and can be changed). "

See http://www.methods.co.nz/asciidoc/userguide.html#X73 for how to
change subsnormal to include callouts.

Cheers
Lex

Is there any way to use callouts within a table?

davide.cavestro — 2012-05-17T09:32:35

Hi,
just wondering if there's a way to use callouts within a table?
Something like

.An example table
[options="header,footer"]
|=======================
|Col 1|Col 2      |Col 3
|1    |Item 1     |a
|2    |Item 2     |b
|3    |Item 3     |c
|6    |Three items|d <1>
|=======================
|<1> callout text

where <1> should be linked with the relevant callout text.

Should I use another syntax or change some table processing related
settings?

Cheers
Davide

Re: Problem with other backends than html / docbook

Gour — 2012-05-15T05:38:30

On Sun, 13 May 2012 17:16:02 -0700 (PDT)
Tom <tombaker17-Re5JQEeQqe8AvxtiuMwx3w< at >public.gmane.org> wrote:


:-)


After installing it, I was able to get article.txt built.


Interesting...

I did try with the above mentioned file, but, still, AsciiDoc fails with
article.txt.

asciidoc: ERROR: asciidoc.txt: line 5976: undefined filter attribute in
command: "{python2}" "{asciidoc-file}" -b {backend}
{asciidoc-args}{lang? -a "lang={lang}< at >"}{icons? -a icons -a
"iconsdir={iconsdir}"}{imagesdir? -a "imagesdir={imagesdir}"}{data-uri?
-a data-uri} -a "indir={indir}"{trace? -a "trace={trace}"}{blockname? -a
"blockname={blockname}"} -s -


I'm not very familiar with latex' low-level details and considering that
we have job which has to be done, I'm going to proceed with converting
my HTML --> PDF by using LyX and LaTeX fine-tuning.

Waiting for another opportunity to deploy AsciiDoc.

Thank you for your input.


Sincerely,
Gour

Re: Problem with other backends than html / docbook

Tom — 2012-05-14T23:10:19

Regarding my question, I did see the recent update to Geoff Eddy's "Bugs in 
asciidoc latex backend"  from a little after 3.6.7 came out.

http://www.methods.co.nz/asciidoc/latex-bugs.html

He explains why the tables are getting colspecs that assume 15 left 
justified columns.


On Sunday, May 13, 2012 8:16:02 PM UTC-4, Tom wrote:

Re: Problem with other backends than html / docbook

Tom — 2012-05-14T00:16:02

Hi, Gour,

This is a fortuitous posting. I was considering starting a topic like this.

While I know the latex backend is experimental, I also know my needs are 
simple and I thought I might not push it past its limits.  Lately I gave it 
a try.

So two things ...

1) 

To answer the thread's question first -- I got the same error.  You see, 
the manual says somewhere that asciidoc will try to load in all the filters 
it finds in the filter directory.  That includes the source-filter (or 
whatever it's called, see below) filter.  But there's something wrong with 
it, so even if you aren't using source-highlight-filtering, you get an 
error.

My favorite theories about it are: You might have to install the 
source-highlight package to get it to work.  OR .... the name of the source 
hilight filter may have changed recently, and the asciidoc referencing 
hasn't caught up yet.

Anyway ... WORKAROUND ... The way to turn the thing off is to create a file 
named 

    __noautoload__

in the folder with the filter'

Re: Help needed: fedora package update

Dag Wieers — 2012-05-09T13:26:29


It depends. If it is shipped as part of asciidoc it is easier to 
maintain/update by Stuart, which may be harder when it ships with vim.

AFAIK all of the syntax-files in vim-common are maintained as part of vim. 
So the real question is if Stuart is interested in this.

PS This is not a packager's decision IMO. Otherwise it becomes a 
maintenance nightmare.

Re: Help needed: fedora package update

Olivier Bilodeau — 2012-05-09T12:57:44

I see your point. I'll ask the maintainer.

However I just realized that most vim ftplugin are provided by
vim-commons (it provides 175 of them) and not individually provided by
git, dpkg, mplayer or xfree86 (as a few examples).

So maybe that's the route it should take?

Re: Help needed: fedora package update

Dag Wieers — 2012-05-09T08:42:31


I'll give you my view of sub-packages on this. I think Fedora is making 
the mistake to create too many sub-packages and loosing control over what 
makes packages useful.

I don't see the point in making a separate vim sub-package, given that the 
vim syntax file is pretty small, a sub-package does not offer anything 
subtantially, a subpackage increases the chance that someone will not 
install it and does not know it exists which is bad for the repository and 
the project (in this case vim and/or asciidoc) and most of all, there is 
no real downside to shipping the plugin even when vim is not installed.

So my opinion is that these sub-package rules is a form of bureaucratic 
autism, where any introduced rules are more important than the case at 
hand and defy common sense.

Of course, there are cases where they can make sense.

Re: asciidoc, a2x, fop and page size

Lex Trotman — 2012-05-07T22:38:58

See FAQ #3 for pointers to backend options.

Cheers
Lex

Re: Bulleted list in a labeled list item

Stuart Rackham — 2012-05-07T19:11:49


On 08/05/12 05:53, Buce wrote:

Alternatively you could append an Open Block 
(http://www.methods.co.nz/asciidoc/userguide.html#X15):

*edit* [file|action]::
         Edit 'file' in the server directory.
+
--
If 'file' does not exist,
edit the action script for 'action' instead. When editing a new action or
overriding a system action, clicraft will create a new user action using one
of these templates:

* {CONFDIR}/action.d/action.sh.example
* {CONFDIR}/action.d/action-override.sh.example

When no 'file' or 'action' is present, edit linkman:clicraft.conf[5].
--

Cheers, Stuart

Re: Bulleted list in a labeled list item

Buce — 2012-05-07T17:53:01




Realized my mistake a few minutes after sending this: I needed a blank line
to end the bulleted list, followed by a single plus (+) sign to continue
the labeled list. http://sprunge.us/iaIK is the corrected version.

Sorry for the noise.

Bulleted list in a labeled list item

Buce — 2012-05-07T17:45:48

Hi,

I'm trying to put a bulleted list in the middle of an item of a
labeled list, like so:

http://sprunge.us/bQTM

The problem I am having is that I can't figure out how to end the
bulleted list item while continuing the labeled list item. The
sentence starting with "When no 'file' or 'action' is present" in the
snippet above is supposed to get indented once, but is currently
aligned with the leftmost margin. When I add a single plus (+)
character on the line before it for a list continuation, it gets
indented to match the bulleted list instead of the labeled list.

I searched google and looked through the documentation regarding
labeled and bulleted lists, and found no answer. Is there any way to
do what I'm trying to accomplish?

Re: Help needed: fedora package update

Olivier Bilodeau — 2012-05-07T16:45:55


I've taken one patch and according to a Repoforge admin in #repoforge,
it's fine:


We went on a little bit and, of course, he told me he is not a lawyer.
Due to size of the said "borrowed work" and the positive reaction of
someone embodying that community, I think it'll be an acceptable
contribution for Fedora.

I contacted the maintainer. He gave me two other things to do:

- vim plugin should be separately [sub]packaged
- build the git doc with it and it shall still be pretty

I'll get to tasks, eventually, and let you guys know.

Cheers!

Re: asciidoc, a2x, fop and page size

Tong — 2012-05-07T14:06:07


On May 7, 2:11 am, Stuart Rackham <srack...-Re5JQEeQqe8AvxtiuMwx3w< at >public.gmane.org> wrote:


Yeah, I thought so.

So, any way to control the generated pdf page size?

Thanks

Re: asciidoc, a2x, fop and page size

Stuart Rackham — 2012-05-07T06:11:35


On 07/05/12 17:12, Tong wrote:

I see now, the a2x program in the link you posted is not the AsciiDoc a2x, and 
is unrelated to the AsciiDoc project, which is why the options aren't recognized.

Cheers, Stuart

Re: asciidoc, a2x, fop and page size

Tong — 2012-05-07T05:12:15


On May 7, 12:00 am, Stuart Rackham <srack...-Re5JQEeQqe8AvxtiuMwx3w< at >public.gmane.org> wrote:

Thanks Stuart,

The fop doesn't seem to have the "-letter" option:

a2x -v --fop --fop-opts "-letter" letter-sample.txt
. . .
a2x: executing: fop -letter -fo /tmp/letter-sample.fo -pdf /tmp/letter-
sample.pdf
. . .
SEVERE: Exception
java.lang.IllegalArgumentException: Error creating InputHandler
object.
        at
org.apache.fop.cli.CommandLineOptions.createInputHandler(CommandLineOptions.java:
849)
        at
org.apache.fop.cli.CommandLineOptions.parse(CommandLineOptions.java:
167)
        at org.apache.fop.cli.Main.startFOP(Main.java:154)
        at org.apache.fop.cli.Main.main(Main.java:197)
a2x: ERROR: fop -letter -fo /tmp/letter-sample.fo -pdf /tmp/letter-
sample.pdf returned non-zero exit status 1

Thanks.