I want to embed Google docs - and possibly Google sheets - in a GitLab markdown file.
GitLab's markdown guide lists the following steps to do this:
open your Google document
click File -> Publish to the web
choose Embed
click on Publish and copy the <iframe>
go to your markdown file and wrap the iframe into a <figure> tag with the responsive video_container class like in this example:
<figure class="video_container">
<iframe src="https://docs.google.com/spreadsheets/d/1jAnvYpRmNu8BISIrkYGTLolOTmlCoKLbuHVWzCXJSY4/pubhtml?widget=true&headers=false"></iframe>
</figure>
Unfortunately this does not work for me. Instead of the embedded document I only see whitespace.
this guide or this one are refering to Kramdown which is a Markdown converter used by https://about.gitlab.com:
For about.GitLab.com we use kramdown, which is an advanced Markdown
engine with a lot of interesting features that most of the other
engines don't have, such as inline attribute lists (IALs), which
enable easy styling beyond the standard Markdown options.
This guide was dedicated mainly for building static website by rendering markdown using kramdown (essentially for writing blog post) :
This guide has been made to make it easier for everyone to use
kramdown features and save a lot of time writing content for
about.GitLab.com, including handbook pages, website pages, blog posts
and everything else within the project www-GitLab-com.
Gitlab.com, Gitlab CE and Gitlab EE uses Github Flavored Markdown, an extension of common mark :
In most of GitLab text areas you'll find markdown support. Not all of
them run with kramdown, so the markup will not behave equally
"GitLabwide". For GitLab.com, GitLab CE and GitLab EE text areas, the
markdown engine is currently CommonMarker. Here you can find the
markdown style guide for them.
If you are interesting in rendering Markdown in Gitlab file (eg Readme, etc...), the Markdown guide is https://docs.gitlab.com/ee/user/markdown.html
Embedding Google sheet in GitLab Flavored Markdown is not possible, unless you want to just include a picture of it or if you want to copy/paste the spreadsheet content to markdown format
Related
I'm trying to use Github pages to both host my source files (strictly markdown with LaTeX equations) and manage the equation rendering when hosting the actual webpage. If I understand this process correctly, github uses Jekyll to statically generate the website, I guess converting all my .md into .html, so I don't have to.
I've read so many posts at this point indicating that I just have to include some lines in my html to run some javascript to use MathJax. I don't know javascript or html so most of the answers seem unclear to me.
Does anyone have a I need a barebones index.md hosted on github.io that renders MathJax.
I've tried:
Creating files in layouts/default.html
<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax#3/es5/tex-mml-chtml.js"></script>
In _config.yml:
usemathjax : true in _config.yml, an
In the __*.md__itself (YAML Front matter):
---
usemathjax : true
---
My website is here with this page showing an html rendered from the markdown automatically via github, the other pages I generated the html locally in VS Code which doesn't scale properly on mobile and not what I want if github can just manage it directly. The source code is here for my repo.
We currently use GitHub for our code repos, which include HTML files for documentation. On GitHub, the HTML files in the repo only display the HTML source, but I can publish it to GitHub Pages, where it displays as a regular web page for my users.
We have just begun the migration to BitBucket hosted within my organization. It looks like the BitBucket Pages plug-in is the equivalent to GitHub Pages, but we don't have that plug-in and I do not expect to get it. Without that plug-in, is there a way to display HTML files as a web page? We also have JIRA and Confluence, in case those help.
I currently document my Python code with pdoc (pdoc3) to create HTML documentation. I don't think this question is specific to Python or pdoc3, but I just thought I'd add that, in case it matters. (I like pdoc3, but if another tool solves my problem, I'll try it.)
In short, how do I display HTML in BitBucket without the Pages plug-in?
I created a wiki using mediawiki 1.28 and installed Translate & UniveralLanguageSelector extensions to create pages in two languages.
I need to create a list of available translations for current page (something like interwiki links of wikipedia)
How can i have a list of available translations of each page ?
Put <languages /> on top of the page. This is mentioned in the (admittedly somewhat sprawling) documentation.
Can Reveal.js read from an external markdown file without requiring node.js? Or will embedded markdown (in the html) work without node.js. In other words, I need to use Apache and can't accommodate node.js.
I am relatively new to Rails, having recently completed Hartl's Rails Tutorial, and am now embarking on my first full fledged project. What I am interested in adding to my web app is something similar to the text input feature in SO, where you could type, and see directly how your text will turn out. After some digging around on SO, I have decided on using the gem bluecloth, which is Markdown implemented in Ruby, but now have the following questions:
I am unsure about how to tie what bluecloth outputs to the form_for helper. My understanding was that you could convert to strings via the function html = BlueCloth.new(str).to_html(), but I am unsure what to do when you have a text field as part of form_for, where I should plug in the bluecloth part? In other words, I am still a bit confused about the magic of typing in one box and seeing the item show elsewhere on the page.
Are the WMD bar button items and functions included Markdown editors (such as bluecloth), or would this be something I have to build manually? If so, how would I get something like the bold button to show "** **" in the editor as you type?
Thanks for your help!
As comments have noted, Markdown is a markup language like HTML, so its not easy to do WYSIWYG.
There are probably two approaches to getting this kind of functionality.
Server side
Post your markdown text to a server and get the server to return HTML. I've done this a lot in Python, but for Ruby this SO answer suggests maruku. The disadvantage of this approach is that it requires a server request every time you want to view the preview, and then some way to integrate that back into your UI without disrupting the user. Stackoverflow uses this approach with the WMD editor and some C# on the server.
Client side
Another option is to use a client side library to take your markdown "code" and generate html which you can then integrate into your page using javascript. An example of this is dillinger. This uses a textarea and something like showdown to render the HTML in the browser. I'm taking this approach one step further in a WYSIWYG Markdown editor I'm developing called demarcate.js
Or... ditch Markdown
The comments have already suggested alternative WYSIWYG editors... most of these are not markdown editors but rich text editors which produce HTML at the end. TinyMCE and wysihtml5 are good options and I've also used CKeditor before with some success - it has a cool "in-place" feature in the latest version which inspired my Markdown editor above.