buddycloud / buddycloud.com Goto Github PK

View Code? Open in Web Editor NEW

18.0 18.0 18.0 43.29 MB

buddycloud static site generation and gh_pages

Home Page: http://buddycloud.com

License: Other

Makefile 1.26% Ruby 1.99% HTML 77.18% Shell 0.71% Python 8.07% CSS 8.99% JavaScript 1.79%

buddycloud.com's People

Contributors

Stargazers

Watchers

Forkers

lloydwatkin victor87820 rodrigods webbj74 fiblan chuwy pniederlag mrfrety julierhill bnolan hengesense jean guilhermesgb robotnic freaking1 ianopolous ayrymlipsecocfa simongarisch

buddycloud.com's Issues

Page footer

Hi @guilhermesgb we really need a footer that behaves something list this one:
http://getbootstrap.com/examples/sticky-footer-navbar/

We will need it for the non-homepage pages.

document local search in buddycloud.com/slate-api

https://github.com/buddycloud/buddycloud.com/blob/master/slate/source/includes/_search.md

and visible here: http://buddycloud.com/slate-api#search

Fix fonts inside SVG diagrams

For example the SVG diagram on http://new.buddycloud.com/architecture looks really bad unless you have open sans installed on your system.

@vitoravelino or @mrflix do you have any ideas?

No newline for the snippets of code

Newline are not generated from Markdown file for snippets of code. This is visible on the install page: http://buddycloud.com/install.

Thanks.

Add Travis-ci building

Something similar to the buddycloud-xep would be nice (https://github.com/buddycloud/buddycloud-xep/blob/master/.travis.yml)

See how it works here: https://travis-ci.org/buddycloud/buddycloud-xep

Migrate Install page

The last "big" page on buddycloud.org is our install page - we need to migrate this one over from https://buddycloud.org/wiki/Install‎ to /install.

Last time I had to do this I used pandoc: http://johnmacfarlane.net/pandoc/ to migrate wiki text to markdown.

slate-api: menu style

Regarding the remaining tasks on the slate-api:

The left hand menu isn't the correct Buddycloud style (also on buddycloud.com site).

The correct style is at http://janlindenberg.net/buddycloud/style-guide.html# (or downloadable at https://drive.google.com/folderview?id=0B8fJyujQqIAJY25qSF9VcjYzbTA&usp=sharing

issues:

spacing
text colour

SVG diagrams: font size should be 13 point

Content flows too wide on large screens

The site is flowing too wide. We should cap the width of the main container. @vitoravelino could you help us?

Slate missing renamed files

The recently renamed files _social-recommendaton.md and _content-recommendation.md are not being included.

Creating new pages without them appearing on the menu

I created https://github.com/buddycloud/buddycloud.com/blob/master/content/pages/features-full.html but don't want it to be appearing on the main menu. Is there a good way to achieve this?

Have the API page generate an on-page menu (Like the menu on the side of http://middlemanapp.com/helpers/ or http://developer.github.com/v3/issues/) based off the H2 and H3 level markdown headings. What's the best way to do this based off the headings in the api.md file?

missing /api page

Seems to have disappeared.

Build seems to be broken

I'm not sure what changed, but it seems that the build isn't happy. There was a pull request from Lloyd but I don't see how that could have changed things.

➜  buddycloud.com git:(master) ✗ make devserver
/Users/simon/Documents/src/buddycloud.com/develop_server.sh restart
Killing pelican.server
Stale PID, deleting
Starting up Pelican and pelican.server
DEBUG: Adding current directory to system path
DEBUG: Temporarily adding PLUGIN_PATH to system path
DEBUG: Restoring system path
DEBUG: Missing dependencies for asc
  --- AutoReload Mode: Monitoring `content`, `theme` and `settings` for changes. ---
DEBUG: Temporarily adding PLUGIN_PATH to system path
DEBUG: Restoring system path

-> Modified: content, theme, settings. re-generating...
DEBUG: template list: [u'!simple/archives.html', u'!simple/article.html', u'!simple/author.html', u'!simple/authors.html', u'!simple/base.html', u'!simple/categories.html', u'!simple/category.html', u'!simple/gosquared.html', u'!simple/index.html', u'!simple/page.html', u'!simple/pagination.html', u'!simple/tag.html', u'!simple/tags.html', u'!simple/translations.html', u'.DS_Store', u'archives.html', u'article.html', u'author.html', u'authors.html', u'base.html', u'categories.html', u'category.html', u'gosquared.html', u'includes/addthis.html', u'includes/article_info.html', u'includes/comment_count.html', u'includes/comments.html', u'includes/disqus_script.html', u'includes/ga.html', u'includes/github.html', u'includes/sidebar.html', u'includes/taglist.html', u'includes/translations.html', u'index.html', u'page.html', u'pagination.html', u'style-guide.html', u'tag.html', u'tags.html', u'translations.html']
DEBUG: template list: [u'!simple/archives.html', u'!simple/article.html', u'!simple/author.html', u'!simple/authors.html', u'!simple/base.html', u'!simple/categories.html', u'!simple/category.html', u'!simple/gosquared.html', u'!simple/index.html', u'!simple/page.html', u'!simple/pagination.html', u'!simple/tag.html', u'!simple/tags.html', u'!simple/translations.html', u'.DS_Store', u'archives.html', u'article.html', u'author.html', u'authors.html', u'base.html', u'categories.html', u'category.html', u'gosquared.html', u'includes/addthis.html', u'includes/article_info.html', u'includes/comment_count.html', u'includes/comments.html', u'includes/disqus_script.html', u'includes/ga.html', u'includes/github.html', u'includes/sidebar.html', u'includes/taglist.html', u'includes/translations.html', u'index.html', u'page.html', u'pagination.html', u'style-guide.html', u'tag.html', u'tags.html', u'translations.html']
DEBUG: template list: [u'!simple/archives.html', u'!simple/article.html', u'!simple/author.html', u'!simple/authors.html', u'!simple/base.html', u'!simple/categories.html', u'!simple/category.html', u'!simple/gosquared.html', u'!simple/index.html', u'!simple/page.html', u'!simple/pagination.html', u'!simple/tag.html', u'!simple/tags.html', u'!simple/translations.html', u'.DS_Store', u'archives.html', u'article.html', u'author.html', u'authors.html', u'base.html', u'categories.html', u'category.html', u'gosquared.html', u'includes/addthis.html', u'includes/article_info.html', u'includes/comment_count.html', u'includes/comments.html', u'includes/disqus_script.html', u'includes/ga.html', u'includes/github.html', u'includes/sidebar.html', u'includes/taglist.html', u'includes/translations.html', u'index.html', u'page.html', u'pagination.html', u'style-guide.html', u'tag.html', u'tags.html', u'translations.html']
DEBUG: read file CNAME -> Static
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c3210; u'static_generator_preread'>.send(<pelican.generators.StaticGenerator object at 0x1109d88d0>)
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c3250; u'static_generator_context'>.send(<pelican.generators.StaticGenerator object at 0x1109d88d0>, <metadata>)
DEBUG: read file pages/all-features.html -> Page
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c3190; u'page_generator_preread'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>)
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c31d0; u'page_generator_context'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>, <metadata>)
DEBUG: read file pages/api.md -> Page
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c3190; u'page_generator_preread'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>)
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c31d0; u'page_generator_context'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>, <metadata>)
DEBUG: read file pages/software.html -> Page
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c3190; u'page_generator_preread'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>)
DEBUG: signal <blinker.base.NamedSignal object at 0x1103c31d0; u'page_generator_context'>.send(<pelican.generators.PagesGenerator object at 0x1109e0790>, <metadata>)
-> copying /Users/simon/Documents/src/buddycloud.com/content/CNAME to CNAME
-> writing /Users/simon/Documents/src/buddycloud.com/output/feeds/all.atom.xml
-> writing /Users/simon/Documents/src/buddycloud.com/output/index.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/style-guide.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/api.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/all-features.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/software.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/contact.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/features.html
-> writing /Users/simon/Documents/src/buddycloud.com/output/get-started.html
CRITICAL: (ExpatError('not well-formed (invalid token): line 41, column 12',),)
CRITICAL: not well-formed (invalid token): line 41, column 12
Traceback (most recent call last):
  File "/usr/local/bin/pelican", line 9, in <module>
    load_entry_point('pelican==3.3', 'console_scripts', 'pelican')()
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pelican/__init__.py", line 350, in main
    pelican.run()
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pelican/__init__.py", line 181, in run
    p.generate_output(writer)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pelican/generators.py", line 535, in generate_output
    override_output=hasattr(page, 'override_save_as'))
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pelican/writers.py", line 211, in write_file
    override_output)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/pelican/writers.py", line 148, in _write_file
    output = template.render(localcontext)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/jinja2/environment.py", line 969, in render
    return self.environment.handle_exception(exc_info, True)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages/jinja2/environment.py", line 742, in handle_exception
    reraise(exc_type, exc_value, tb)
  File "/Users/simon/Documents/src/buddycloud.com/buddycloud-theme/templates/page.html", line 4, in top-level template code
    {% set toc_info = page.content|extract_toc_info %}
  File "/Users/simon/Documents/src/buddycloud.com/jinjaext/table_of_contents.py", line 56, in extractTableOfContentsInfo
    root = ElementTree.fromstring("<root>"+content+"</root>")
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/xml/etree/ElementTree.py", line 1300, in XML
    parser.feed(text)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/xml/etree/ElementTree.py", line 1642, in feed
    self._raiseerror(v)
  File "/usr/local/Cellar/python/2.7.6/Frameworks/Python.framework/Versions/2.7/lib/python2.7/xml/etree/ElementTree.py", line 1506, in _raiseerror
    raise err
xml.etree.ElementTree.ParseError: not well-formed (invalid token): line 41, column 12

Missing side menu on architecture and features pages.

The side menu is really nice! But missing - could we please add it to these pages too.

slate-api: table style

regarding the remaining tasks on the slate-api pages:

tables need styling to Buddycloud table style.
probably best to use the condensed style for this.

Page title question

I'm trying to have the following:

<title>Buddycloud Architecture</title>

Top menu title=Architecture

Title on page="Architecture"

But it ends up looking like this:

Anyway to make this work?

Javascript highlighting

Make sure <code class="javascript"> works.

favicon.ico

Looks like Jan's favicon isn't making it into this repo: http://janlindenberg.net/buddycloud/static/img/icons/favicon.ico

Explain buddycloud better on the homepage

Kristin - we need to add a better explanation of Buddycloud here.

Messaging toolbox etc

small css fixes

Note to myself:

<li> tags are outside the margin and look odd.
<h2> we needs love: the horizontal line above the H2 tag just looks odd. Time to get rid of it forever.

logo missing

The top left "b" logo is missing from page builds.

Active page

Have a way to indicate the active page in the menu (but not for the homepage).

Wrong username and database name for the database test

On the install page, in the "buddycloud Server" section, it is proposed to test the database with this command:
psql -h 127.0.0.1 --username buddycloudserver -d buddycloudserver -c "select * from nodes;"

The username and the database name are wrong. Here is a correction:
psql -h 127.0.0.1 --username buddycloudserverjava -d buddycloudserverjava -c "select * from nodes;"

Contact and bio page

Needs a lot of work

slate-api: <aside> style

The

style needs definition according to http://konigi.com/tools/css-sticky-notes

(stripe example use https://stripe.com/docs/webhooks)
float right

404 page missing

Something like

<script type="text/javascript">
  var GOOG_FIXURL_LANG = 'en';
  var GOOG_FIXURL_SITE = 'http://www.example.com'
</script>
<script type="text/javascript"
  src="http://linkhelp.clients.google.com/tbproxy/lh/wm/fixurl.js">
</script>

(see: https://support.google.com/webmasters/answer/136085)
would be useful.

fix the table of contents in the sidebar and scrolling offset

It used to have a nice scrolling effect to the right offset and the "selected" element in the table of contents was matching the viewed content nicely.
After getting the new style from Jan this no longer happens, see what's changed and get it back.

Inside pages need to be more responsive for small screens.

Eg /features page on a mobile.screen.

API Table

Have the API table render the tables (Visibility section).

Black menu-bar box - shouldn't inverse

E5E9EF

Nasty nasty nasty

This

should be

Missing properties for the prosody's configuration file

During my attempts to install buddycloud server, I noticed the lack of two component definitions in the configuration file of prosody:

Component "channels.EXAMPLE.com"
        component_secret        = "tellnoone"

Component "topics.EXAMPLE.com"
        component_secret        = "tellnoone"

These definitions are described on https://buddycloud.org/wiki/Install_Java_channel_server#Prosody_configuration

Without these definitions, the server fail to start.

Unable to reset password

I am unable to reset the password and have been through three identities. The "Forgot password?" link on the "Sign In" dialogue does not work.

Table of contents not generating on how-buddycloud-works.html not working.

Table of contents not generating on how-buddycloud-works.html not working.

<meta name="table_of_contents" content="true" />

Add diagrams to the architecture page

API page is unmaintainable

Hard to find content, read and modify. Please use partials for the god sake.

Check https://github.com/buddycloud/buddycloud-styles/tree/master/docs/theme/templates for an example.

Do not exaggerate mixing Markdown with HTML. I suggest going with HTML because you are more flexible to do whatever you want to and stay as semantic as possible. There's a bunch of content being rendered not semantically but from editor's perspective it's beautiful to read and modify that part. Keep it simple. It's just horrible.

I didn't assign this to myself yet because I have other things with higher priority at the moment. If nobody do this, I'll do it later.

If you have any question, ask below.

Emphasise quickness - 2 minutes to being productive.

We need to show how quick and easy it is.

This is my proposal

I'd love feedback.

The text would say

Step1: git clone ; npm i ; npm...
Step2: open 127.0.0.1:3000
Step3: "start building your "

Then for flipping text we have the following strings replaced:

Chat client
personal social network
private cloud
webRTC client
social activity stream
indyweb project

Thoughts? Ideas?

based on

Built with Buddycloud carousel

Using the standards bootstrap carousel: http://getbootstrap.com/javascript/#carousel-usage

Mockup:

Search engine

image: https://github.com/buddycloud/buddycloud.com-old/blob/master/img/screenshots/originals/explore.jpg
text: The Buddycloud Search Engine indexs, finds, and recommends public content.

Webclient

image: https://github.com/buddycloud/buddycloud.com-old/blob/master/img/screenshots/originals/private-channels.jpg
text: The Buddycloud Webclient is a demo client built on uses backbone.js. Check out a demo.

bccc

image: https://www.dropbox.com/s/xnr7sdnvx3ueoo1/687474703a2f2f692e696d6775722e636f6d2f33357833392e706e67.png
text: BCCC is a Python based Buddycloud client.

Android

https://www.dropbox.com/s/li7vq11p28yarwv/2014-04-09%2012.48.19.png
text: The demo Android client uses Buddycloud's HTTP API and push notification service.

Finish demo page (http://buddycloud.com/developers)

Not sure where we are up to with this - last I recall @guilhermesgb was working with @lloydwatkin on this.

@guilhermesgb what's the next step to roll this out?

/style-guide is missing

http://buddycloud.com/style-guide has disappeared.

Generating unordered lists broken?

I've tried

* list item1
* list item2

and

- list item 1
- list item 2

Any ideas?

Ways to improve the API page

@guilhermesgb and @imaginator thinking about ways to improve the API page:

simple curl demos for all API calls that help the developer get real results (using buddycloud.org)
"enter your buddycloud domain" and then perform a lookup for the endpoint and pre-populate all the curl commands to do everything on the domain.
be inspired by https://stripe.com/docs/api/curl#create_subscription
better way to show the tabs and text (looks a bit disjointed at the moment)

Open to more ideas?

Selected side menu item now with a box around it.

Problem generating TOC

The TOC's generation is breaking the build on the recipe page:

d52705f

broken hyperlinks on http://buddycloud.com/api

The links "buddycloud HTTP API server" and "XMPP interface" in the first paragraph "API" of http://buddycloud.com/api are broken

Feedback on doing the recipe

@mskaru and me were trying the recipe.

Some feedback:

embed the code-open demo into the start of the instructions.
you have the code at the bottom of the page (https://github.com/guilhermesgb/chat-recipe) but tell the user to fork the skeleton at the top! Very confusing. IMHO you should be telling them to fork https://github.com/guilhermesgb/chat-recipe at the start of the recipe.
you make the user register a username but then login with a username and domain- never make the user enter a domain (silently add @buddycloud.org if necessary)
trying to post as a new user I get the following:
later a few messages appear in the screen but for someone who doesn't know what buddycloud is yet, these are confusing - perhaps say where they are coming from:

For these projects, I suggest we keep things separated for each recipe:
chat-recipe

chat-recipe
- views
- public
next-recipe
- views
- public

Alternative: [Install from source](Install from source "wikilink")