Name: synapseDocs
Owner: Sage Bionetworks
Description: Synapse documentation pages
Created: 2016-03-09 17:02:49.0
Updated: 2017-03-08 19:48:39.0
Pushed: 2018-01-16 20:08:18.0
Homepage: http://docs.synapse.org
Size: 17527
Language: CSS
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This is a documentation site for Synapse. Synapse is an open source software platform that data scientists use to carry out, track, and communicate their research in real time.
Synapse Docs is generated using Jekyll and uses redcarpet to render Markdown. Various page layouts can be found under the _layouts folder in the home directory. Most everything can be written using standard Markdown.
Internal development can be performed by branching from develop to your own feature branch, making changes, pushing the branch to this repository, and opening a pull request. Pull requests against the master branch require a review before merging.
To create a page using the article layout, start by specifying at the very beginning the title, layout, excerpt, and category in the YAML front matter. The title and excerpt will show up in the article's user guide thumbnail and the category tag will be used to sort the article into its corresponding user guide tab. If no category is specified, it will default into the “How-To” tab.
category options: intro, howto, governance, dream, inpractice
Note that the front matter needs to be enclosed between three dashed lines to work properly.
e: Name of page here
ut: article
rpt: A blurb about this page that will show up as a description in the user guide.
gory: intro
Article content should begin with a short summary describing what the page is about. Each header on the page will be rendered on the sidebar menu as well for easier navigation.
You can use Liquid tags to show a code example in multiple languages. Follow the format below for as many languages as you'd like, ensuring that the languages are in alphabetical order.
abs %}
tab Command %}
{% highlight bash %}
some code here
{% endhighlight %}
endtab %}
tab Python %}
{% highlight python %}
more code here
{% endhighlight %}
endtab %}
tab R %}
{% highlight r %}
add code here
{% endhighlight %}
endtab %}
tab Web %}
Instructions for Web + screenshots
endtab %}
ndtabs %}
There are four types of alert highlighting to inform users: note, tip, warning, and important. You can insert an alert by using any of the following code in a markdown file.
nclude note.html content="This is a note." %}
nclude tip.html content="This is a tip." %}
To include new paragraphs, just add the <br/> tag within the content, like this:
nclude warning.html content="This is a warning. `<br/>` This is the second line of the warning." %}
nclude important.html content="This is for an important message." %}
To add a table, use Liquid to call on the markdown-table css class. Then use the standard markdown table format.
arkdown-table}
ader 1 | Header 2 |
- | --- |
ntent | content |
ntent | content |
Images can be inserted using either Markdown or HTML, it all depends on your preference. The examples below will display the same thing:
t text](/assets/images/image1.jpg)
src="/assets/images/image1.jpg" alt="alt text">
With Bundler:
bundle install
npm install
bundle exec jekyll serve
then navigate to localhost:4000
./bin/jekyll build
Solving common bugs while regenerating Connection refused error:
Source: .
Destination: ./_site
remental build: disabled. Enable with --incremental
Generating...
nversion error: Jekyll::BrowserifyConverter encountered an error while converting '/js/all.js':
Connection refused - connect(2)
ll 3.1.2 | Error: Connection refused - connect(2)
When you get this error, simply run this command several times before regenerating again.
it -n 10000
Distributed under the Eclipse Public License, the same as Clojure.