User:Kbjarkefur
About me
- Kristoffer Bjärkefur
- Work with developing best practice and software tools at DIME
- See https://github.com/worldbank/ietoolkit
- kbjarkefur@worldbank.org
Pages on this wiki I frequently need:
- Stylesheet : MediaWiki:Common.css
- Javascript : MediaWiki:Common.js
Code snippet example
This part is using the regular <code> tag which is great when writing code in the middle of a sentence:
Ex.1 Use the egen function rowtotal() when aggregating variables.
However, the <code> tag is not great when writing multiple lines of code because there is a space in the formatting between the lines. It doesn't feel like a single code snippet.
Ex.2
gen varA = .
replace varA = 1 if gender == 1
replace varA = 0 if gender == 0
One solution to this that I found was to use the <pre> tag. Multiple lines displays really nice (and I like the color better):
Ex.3
gen varA = . replace varA = 1 if gender == 1 replace varA = 0 if gender == 0
However, the <pre> tag is no good for when writing code in the middle of a sentence. Ex.4 is the same code as Ex.1 but with a <pre> tag instead of a <code> tag (this was supposed to have been on one line):
Ex.4 Use the egen function
rowtotal()
when aggregating variables.
Summary and suggested solution: What I have done in my examples I uploaded today was to use <pre> for multi-line code examples and <code> for inline code examples, but as they look quite different in color I do not think it is a great solution. It won't be obvious that both are code examples. Not our top priority perhaps, but since there will be plenty of code examples we should decide on a standard for how we do this.
Both the <pre> tag and the <code> tag are HTML elements that can be formatted with CSS (I checked the page source and in the HTML they do inteed have those tags). I think Ritesh's team should be able to quite easily format one of them to look more similar to the other. The only issue would be if these tags are used as something else already somewhere on the wiki and changing them will mess up what they are also used for.
I do not like the red in the <code> tag that much as it looks like an error so I'd prefer both of them to be like the <pre> but keep both of them working as they are now in terms of position and line break.