Contributing to the Financial Modelling Wiki: Difference between revisions
(Created page with "==Why contribute== Contribute to share information that is useful for people that work with or use financial models. Do not contribute to promote something - though you can contribute in your own name or the name of a business that you represent, and you can mention that in your user page. ==How to contribute== ===In general=== The specifics of contributing to this wiki are mostly like [https://en.wikipedia.org/wiki/Wikipedia:Contributing_to_Wikipedia contributing to W...") |
No edit summary |
||
(11 intermediate revisions by the same user not shown) | |||
Line 15: | Line 15: | ||
Open the page in your browser, then click either "Edit" or "Edit source" (each of these are near the top right). | Open the page in your browser, then click either "Edit" or "Edit source" (each of these are near the top right). | ||
* Edit opens a visual editor. Most people will find this simplest for editing text (including headings, bold / italic / code blocks etc, lists and tables. You cannot embed or change images, GIFs, videos or spreasheets this way. | * <strong>Edit</strong> opens a visual editor. Most people will find this simplest for editing text (including headings, bold / italic / code blocks etc, lists and tables. You cannot embed or change images, GIFs, videos or spreasheets this way. | ||
* Edit | * <strong>Edit source</strong> opens a source editor. The markup language is called [https://en.wikipedia.org/wiki/Help:Wikitext wikitext]. It is similar to HTML. People who are familiar with using any markup language or code will probably find it simple to edit the source, and copy/adapt new elements from other pages. You can embed and changes images, GIFs, videos and spreadsheets this way - refer to the section below on specifics for the Financial Modelling Wiki. | ||
====Creating a new page==== | ====Creating a new page==== | ||
Line 23: | Line 23: | ||
===Specifics for the Financial Modelling Wiki=== | ===Specifics for the Financial Modelling Wiki=== | ||
This wiki is unusual in the need to embed spreadsheets. We were unaware of a suitable native solution and have implemented a custom approach, and that same approach is used for embedding videos, pictures and GIFs. Videos are explained first because they are simplest. | |||
====Embedding spreadsheets==== | |||
# Save the | # <strong>File type</strong> Save the spreadsheet as an Excel .XLSX workbook. The XLSX requirement is a security measure - no macros, please (although it is fine to include code within wiki pages). | ||
# Upload the | # <strong>Upload</strong> the workbook to a publicly viewable location of a <strong>cloud service on an account that we trust</strong>. | ||
# | #* <strong>[https://twitter.com/FinModWiki Tweet us]</strong> if you are not already aware of anyone you know that has a trusted account. | ||
# Find the <strong>regular HTML</strong> <iframe> embed code for the workbook. | |||
#* If the trusted account is a OneDrive - Personal account, [https://chandoo.org/wp/embed-excel-file-on-your-website/ this page] describes a way of finding the regular HTML <iframe> embed code. | |||
#* Test whether the regular HTML <iframe> embed code works. One way to do this is to create an HTML file (which can be done in most simple text editors, like Windows Notepad) and opening in your browser. Test whether the workbook is publicly available by opening in an InPrivate/Incognito window. | |||
# Convert the regular HTML <iframe> embed code to the <strong>wikitext markup</strong> that this wiki uses. | |||
#* You should specify the following attributes: | |||
#** <strong>key</strong> is the identifier for the account that is trusted by this wiki. Note that the key evaluates to the start of the URL - in the first example below the key <code>KEYOFTRUSTEDACCOUNT</code>evaluates to <code><nowiki>https://onedrive.live.com</nowiki>/embed?resid=ACCOUNTIDENTIFIER</code>. The mapping from keys to starts of URLs is specified in an admin area of this wiki when we set up trusted accounts. | |||
#** <strong>path</strong> is the remainder of the path to the workbook. | |||
#** <strong>width</strong> is the width (in pixels) of the embedded workbook as it will be displayed in this wiki. We prefer for this to be 1000 or less so that the embedded workbook renders reasonably on low-resolution monitors. | |||
#** <strong>height</strong> is the height (in pixels). | |||
#* In the following examples, the '''bold''' parts get copied across from the regular HTML <iframe> embed code to the wikitext markup, the ''italics'' parts are lost, and the rest is supporting. | |||
#** OneDrive - Personal | |||
#*** Regular HTML <iframe> embed code: | |||
#***: <code><iframe '''width="1000" height="187"''' ''frameborder="0" scrolling="no"'' src="'''<nowiki>https://onedrive.live.com</nowiki>/embed?resid=ACCOUNTIDENTIFIER%21FILEIDENTIFIER&authkey=%21ACCESSKEY&em=2&AllowTyping=True&'''</code> | |||
#***:'''<code>ActiveCell=<nowiki>'SHEETOFACTIVECELL'</nowiki>!ACTIVECELL&Item=DEFINEDNAMEOFAREATOSHOW&wdHideGridlines=True&</code>''' | |||
#***:<code>'''wdDownloadButton=True&wdInConfigurator=True'''"></iframe></code> | |||
#*** Wikitext markup that this wiki uses: | |||
#***: <code><div style="text-align: center;"><iframe key="'''KEYOFTRUSTEDACCOUNT'''" path="'''FILEIDENTIFIER&authkey=%21ACCESSKEY&em=2&AllowTyping=True&ActiveCell=<nowiki>'SHEETOFACTIVECELL'</nowiki>!ACTIVECELL&'''</code> | |||
#***:<code>'''Item=DEFINEDNAMEOFAREATOSHOW&wdHideGridlines=True&wdDownloadButton=True&wdInConfigurator=True'''" '''width="1000" height="187"'''></iframe></div></code> | |||
# <strong>Apply</strong> the wikitext markup to the relevant page of this wiki. Use <strong>edit source</strong> for this. | |||
[ | ====Embedding videos==== | ||
Embedding videos is simpler than embedding spreadsheets. | |||
# <strong>Upload</strong> the video to [https://www.youtube.com/ YouTube]. We can enable other video sharing platforms if requirements arise - [https://twitter.com/FinModWiki tweet us] if you have a need. | |||
# Ensure that the video settings <strong>allow embedding</strong> on other websites. The standard default is is for embedding to be allowed, so if you are not sure then move on and just keep it in mind in case you have trouble later. If you need to change the setting then search how to do so at the time - the YouTube user interface changes over time and differs between devices/apps etc. | |||
# Find the <strong>unique part of the URL</strong> for your video. For example, if the address bar of the video shows <code>https://www.youtube.com/watch?v=qqU2xllewk4</code>, then the unique part of the URL is <code>qqU2xllewk4</code>. You can usually find a clean version of the URL by clicking "share". | |||
# Determine the <strong>wikitext markup</strong> to embed the video in this wiki. | |||
#* It goes like this: | |||
#*: <code><div style="text-align: center;"><iframe key="YouTube" path="'''UNIQUEPARTOFTHEURLFORYOURVIDEO'''" width="960" height="540"></iframe></div></code> | |||
#* Continuing the example, if the unique part of the URL for your video is <code>qqU2xllewk4</code>, then the wikitext markup is: | |||
#*: <code><div style="text-align: center;"><iframe key="YouTube" path="'''qqU2xllewk4'''" width="960" height="540"></iframe></div></code> | |||
# <strong>Apply</strong> the wikitext markup to the relevant page of this wiki. Use <strong>edit source</strong> for this. | |||
====Embedding pictures and GIFs==== | |||
We expect that pictures and GIFs can be embedded in basically the same way as spreadsheets, but we have not yet had a need to test it. [https://twitter.com/FinModWiki Tweet us] if you have a need and trying to adapt the steps for spreadsheets does not work for you. |
Latest revision as of 00:14, 3 January 2022
Why contribute
Contribute to share information that is useful for people that work with or use financial models. Do not contribute to promote something - though you can contribute in your own name or the name of a business that you represent, and you can mention that in your user page.
How to contribute
In general
The specifics of contributing to this wiki are mostly like contributing to Wikipedia. This page outlines how to perform some common actions.
Creating an account, logging in and logging out
You do not need to create an account to contribute to this wiki, but you are welcome to.
To perform these actions, click either "Create account", "Log in" or "Log out" as appropriate (each of these is near the top right) and follow the prompts.
Editing an existing page
Open the page in your browser, then click either "Edit" or "Edit source" (each of these are near the top right).
- Edit opens a visual editor. Most people will find this simplest for editing text (including headings, bold / italic / code blocks etc, lists and tables. You cannot embed or change images, GIFs, videos or spreasheets this way.
- Edit source opens a source editor. The markup language is called wikitext. It is similar to HTML. People who are familiar with using any markup language or code will probably find it simple to edit the source, and copy/adapt new elements from other pages. You can embed and changes images, GIFs, videos and spreadsheets this way - refer to the section below on specifics for the Financial Modelling Wiki.
Creating a new page
Enter the title into the search box (near the top right corner), click the red link that appears, and follow the prompts.
Specifics for the Financial Modelling Wiki
This wiki is unusual in the need to embed spreadsheets. We were unaware of a suitable native solution and have implemented a custom approach, and that same approach is used for embedding videos, pictures and GIFs. Videos are explained first because they are simplest.
Embedding spreadsheets
- File type Save the spreadsheet as an Excel .XLSX workbook. The XLSX requirement is a security measure - no macros, please (although it is fine to include code within wiki pages).
- Upload the workbook to a publicly viewable location of a cloud service on an account that we trust.
- Tweet us if you are not already aware of anyone you know that has a trusted account.
- Find the regular HTML <iframe> embed code for the workbook.
- If the trusted account is a OneDrive - Personal account, this page describes a way of finding the regular HTML <iframe> embed code.
- Test whether the regular HTML <iframe> embed code works. One way to do this is to create an HTML file (which can be done in most simple text editors, like Windows Notepad) and opening in your browser. Test whether the workbook is publicly available by opening in an InPrivate/Incognito window.
- Convert the regular HTML <iframe> embed code to the wikitext markup that this wiki uses.
- You should specify the following attributes:
- key is the identifier for the account that is trusted by this wiki. Note that the key evaluates to the start of the URL - in the first example below the key
KEYOFTRUSTEDACCOUNT
evaluates tohttps://onedrive.live.com/embed?resid=ACCOUNTIDENTIFIER
. The mapping from keys to starts of URLs is specified in an admin area of this wiki when we set up trusted accounts. - path is the remainder of the path to the workbook.
- width is the width (in pixels) of the embedded workbook as it will be displayed in this wiki. We prefer for this to be 1000 or less so that the embedded workbook renders reasonably on low-resolution monitors.
- height is the height (in pixels).
- key is the identifier for the account that is trusted by this wiki. Note that the key evaluates to the start of the URL - in the first example below the key
- In the following examples, the bold parts get copied across from the regular HTML <iframe> embed code to the wikitext markup, the italics parts are lost, and the rest is supporting.
- OneDrive - Personal
- Regular HTML <iframe> embed code:
<iframe width="1000" height="187" frameborder="0" scrolling="no" src="https://onedrive.live.com/embed?resid=ACCOUNTIDENTIFIER%21FILEIDENTIFIER&authkey=%21ACCESSKEY&em=2&AllowTyping=True&
ActiveCell='SHEETOFACTIVECELL'!ACTIVECELL&Item=DEFINEDNAMEOFAREATOSHOW&wdHideGridlines=True&
wdDownloadButton=True&wdInConfigurator=True"></iframe>
- Wikitext markup that this wiki uses:
<div style="text-align: center;"><iframe key="KEYOFTRUSTEDACCOUNT" path="FILEIDENTIFIER&authkey=%21ACCESSKEY&em=2&AllowTyping=True&ActiveCell='SHEETOFACTIVECELL'!ACTIVECELL&
Item=DEFINEDNAMEOFAREATOSHOW&wdHideGridlines=True&wdDownloadButton=True&wdInConfigurator=True" width="1000" height="187"></iframe></div>
- Regular HTML <iframe> embed code:
- OneDrive - Personal
- You should specify the following attributes:
- Apply the wikitext markup to the relevant page of this wiki. Use edit source for this.
Embedding videos
Embedding videos is simpler than embedding spreadsheets.
- Upload the video to YouTube. We can enable other video sharing platforms if requirements arise - tweet us if you have a need.
- Ensure that the video settings allow embedding on other websites. The standard default is is for embedding to be allowed, so if you are not sure then move on and just keep it in mind in case you have trouble later. If you need to change the setting then search how to do so at the time - the YouTube user interface changes over time and differs between devices/apps etc.
- Find the unique part of the URL for your video. For example, if the address bar of the video shows
https://www.youtube.com/watch?v=qqU2xllewk4
, then the unique part of the URL isqqU2xllewk4
. You can usually find a clean version of the URL by clicking "share". - Determine the wikitext markup to embed the video in this wiki.
- It goes like this:
<div style="text-align: center;"><iframe key="YouTube" path="UNIQUEPARTOFTHEURLFORYOURVIDEO" width="960" height="540"></iframe></div>
- Continuing the example, if the unique part of the URL for your video is
qqU2xllewk4
, then the wikitext markup is:<div style="text-align: center;"><iframe key="YouTube" path="qqU2xllewk4" width="960" height="540"></iframe></div>
- It goes like this:
- Apply the wikitext markup to the relevant page of this wiki. Use edit source for this.
Embedding pictures and GIFs
We expect that pictures and GIFs can be embedded in basically the same way as spreadsheets, but we have not yet had a need to test it. Tweet us if you have a need and trying to adapt the steps for spreadsheets does not work for you.