Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
Next:
badges earned

Your Points Tracker
Challenges
Leaderboard
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Recognition
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Kudos
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Bitbucket RestructuredText README ugly? Edited

RestructuredText README's on Bitbucket looks improperly rendered into HTML at the moment, e.g.

* all the sections are squashed up

* the headings are rendered as hyperlinks that point to themselves

I see that this is a new feature, is it intended to be improved any time soon or is markdown the way to go for now?

 

1 comment

The problem is that sections, which are usually started by headings, do not have any margin defined for them. Meanwhile, the heading that starts a section will be the first child element within that section.

In the bundle.css file that apparently applies to the HTML output, there is a CSS rule like this:

/* remove top margin for first element */
p:first-child,
ul:first-child,
ol:first-child,
dl:first-child,
h1:first-child,
h2:first-child,
h3:first-child,
h4:first-child,
h5:first-child,
h6:first-child,
blockquote:first-child,
pre:first-child,
form:first-child,
table:first-child {
margin-top: 0;
}

So, each section will not have a top margin, each heading at the top of each section will not have a top margin. Consequently, sections will be squashed up.

I suggest that some kind of top margin be incorporated into the rules. Removing the above rule does produce decent-enough layout for my documentation, but others might not entirely agree with what it does to theirs.

Comment

Log in or Sign up to comment
TAGS
Community showcase
Published in Bitbucket

Calling any interview participants for Bitbucket Data Center

Hi everyone,  We are looking to learn more about development teams’ workflows and pain points, especially around DevOps, integrations, administration, scale, security, and the related challeng...

652 views 7 4
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you