You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Greg Mirabito (JIRA)" <ji...@codehaus.org> on 2010/11/19 17:48:03 UTC

[jira] Created: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Generated html from apt is ignoring all paragraph lines
-------------------------------------------------------

                 Key: MSITE-525
                 URL: http://jira.codehaus.org/browse/MSITE-525
             Project: Maven 2.x Site Plugin
          Issue Type: Bug
    Affects Versions: 2.2
         Environment: mac osx
            Reporter: Greg Mirabito


I create a simple apt file with two lines in it.

  This is line1.
  This is line2.

Run mvn site and look at the generated html. There is no line break. 


-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Reopened: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Greg Mirabito (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Greg Mirabito reopened MSITE-525:
---------------------------------


I am not talking about hard line breaks using the '\' character. I am talking about separate lines in a paragraph.

Look at the 'Paragraph section' of same document you referenced.
In the APT doc it states that "A paragraph is a sequence of consecutive lines"

My problem is that the separate lines in my paragraphs all show up on the same line when the html is generated.
If I copy the example paragraph from the apt doc into my own apt doc and run mvn site, the generated html puts the separate paragraph lines on the same line. (no line breaks)


Here is what it says in the APT doc about paragraphs:

A paragraph is simply a sequence of consecutive text lines.

  First line of first paragraph.
  Second line of first paragraph.
  Third line of first paragraph.

  Line 1 of paragraph 2 (separated from first paragraph by an open line).
  Line 2 of paragraph 2.

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Closed: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Dennis Lundberg (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dennis Lundberg closed MSITE-525.
---------------------------------

    Resolution: Not A Bug

This is the expected behavior. See the Doxia reference on the APT format:
http://maven.apache.org/doxia/references/apt-format.html#Line_break

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Greg Mirabito (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243786#action_243786 ] 

Greg Mirabito commented on MSITE-525:
-------------------------------------

Here is the html paragraph that gets generates

  <p>This is line1. This is line2. </p>

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Issue Comment Edited: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Greg Mirabito (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243786#action_243786 ] 

Greg Mirabito edited comment on MSITE-525 at 11/19/10 10:55 AM:
----------------------------------------------------------------

Here is the html paragraph that gets generated

  <p>This is line1. This is line2. </p>

      was (Author: mirabg):
    Here is the html paragraph that gets generatesd

  <p>This is line1. This is line2. </p>
  
> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Dennis Lundberg (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243822#action_243822 ] 

Dennis Lundberg commented on MSITE-525:
---------------------------------------

Greg,

This is the way it is supposed to be. If you want to separate the lines within a paragraph you need to use a forced line break using the \ character. If you don't put any forced line breaks inside the paragraph, the line will break when the window's width is reached, just like a <p> in HTML does and just like a paragraph does in a word processor.

Is there anything in the docs that you find is unclear? If so how could we make it more clear?

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243989#action_243989 ] 

Lukas Theussl commented on MSITE-525:
-------------------------------------

I agree that the documentation could be misleading, e.g. the example at http://maven.apache.org/doxia/references/apt-format.html#Paragraph could lead to the expectation that {{Paragraph 1, line 2}} is always on a separate line than {{Paragraph 1, line 1}}. However, this only refers to the apt document format itself, i.e. line breaks in an apt document are not significant inside paragraphs. When translated to other formats, all lines within the apt paragraph go to one paragraph in the target document, like the html example above shows.

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Greg Mirabito (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243823#action_243823 ] 

Greg Mirabito commented on MSITE-525:
-------------------------------------

Dennis,

Thanks for the response. The documentation does seem to indicate that a forced line break is not required on paragraphs.
However, adding the \ at the end of each line works for me. 

Thanks,
greg

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Issue Comment Edited: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Greg Mirabito (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=243786#action_243786 ] 

Greg Mirabito edited comment on MSITE-525 at 11/19/10 10:55 AM:
----------------------------------------------------------------

Here is the html paragraph that gets generatesd

  <p>This is line1. This is line2. </p>

      was (Author: mirabg):
    Here is the html paragraph that gets generates

  <p>This is line1. This is line2. </p>
  
> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Closed: (MSITE-525) Generated html from apt is ignoring all paragraph lines

Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
     [ http://jira.codehaus.org/browse/MSITE-525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Lukas Theussl closed MSITE-525.
-------------------------------

    Resolution: Not A Bug
      Assignee: Lukas Theussl

> Generated html from apt is ignoring all paragraph lines
> -------------------------------------------------------
>
>                 Key: MSITE-525
>                 URL: http://jira.codehaus.org/browse/MSITE-525
>             Project: Maven 2.x and 3.x Site Plugin
>          Issue Type: Bug
>    Affects Versions: 2.2
>         Environment: mac osx
>            Reporter: Greg Mirabito
>            Assignee: Lukas Theussl
>
> I create a simple apt file with two lines in it.
>   This is line1.
>   This is line2.
> Run mvn site and look at the generated html. There is no line break. 

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira