This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "snap-website".
The branch, master has been updated
via 5acf284126e6204a21742aebe13453d5ef05d704 (commit)
from a944a5600f92e508cc0b9a45db4ace8a54242515 (commit)
Summary of changes:
static/media/css/main.css | 29 +++++++++++-
templates/faq.md | 110 +++++++++++++++++++++++++++++++++++++++++++++
templates/faq.tpl | 98 +++-------------------------------------
3 files changed, 145 insertions(+), 92 deletions(-)
create mode 100644 templates/faq.md
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 5acf284126e6204a21742aebe13453d5ef05d704
Author: Gregory Collins <[email protected]>
Date: Wed Sep 15 00:06:52 2010 -0400
Prettify the faq page
diff --git a/static/media/css/main.css b/static/media/css/main.css
index 976f265..aab56ff 100644
--- a/static/media/css/main.css
+++ b/static/media/css/main.css
@@ -104,7 +104,7 @@ dl span.linklist {
font-family: "PT Sans", "Arial", sans-serif;
}
-pre.code, pre.sourceCode, pre.shell {
+pre.code, pre.sourceCode, pre.shell, .faqs {
background: #222 url(black-screen.png) scroll repeat-x top left;
color: #ffbf00;
width: 87%;
@@ -115,6 +115,14 @@ pre.code, pre.sourceCode, pre.shell {
-webkit-border-radius: 10px;
}
+.faqs a {
+ color: #96C1D4;
+}
+
+.faqs a:hover, .faqs a:active {
+ color: #FFFAEB;
+}
+
#blog-index table {
border-collapse:collapse;
border-spacing:0;
@@ -223,6 +231,7 @@ pre.sourceCode span.InfixOperator { color: #aaa; }
.singlecolumn {
width: 728px;
margin-top: 20px;
+ padding-bottom: 58px;
}
.singlecolumn pre.sourceCode,
@@ -332,6 +341,24 @@ p.foundabug {
margin-top:20px;
}
+#faqspage h3 {
+ font-family: "PT Sans", "Arial", sans-serif;
+ margin:58px 0 14px 0;
+ padding:0;
+ line-height: 43px;
+ border-top: 1px solid #c2d1e1;
+ text-transform: none;
+ color: #705E3A;
+ /*F7D081*/
+}
+
+#faqspage h5 {
+ font-family: "PT Sans", "Arial", sans-serif;
+ padding: 0;
+ margin: 0;
+ line-height: 29px;
+}
+
#main{
background:#fff url(holy-light.png) scroll repeat-x 0px -100px;
margin: 0;
diff --git a/templates/faq.md b/templates/faq.md
new file mode 100644
index 0000000..73e34b7
--- /dev/null
+++ b/templates/faq.md
@@ -0,0 +1,110 @@
+<div id="faqspage">
+## Frequently Asked Questions
+
+<div class="faqs">
+
+1. [How can I report a bug in Snap? ](#how-can-i-report-a-bug-in-snap)
+1. [Is anyone using Snap in production?
](#is-anyone-using-snap-in-production)
+1. [Where's the high-level functionality?
](#wheres-the-high-level-functionality)
+1. [Why can't I install Snap? ](#why-cant-i-install-snap)
+1. [How do I get the libev backend working?
](#how-do-i-get-the-libev-backend-working)
+1. [How can I help? ](#how-can-i-help)
+
+</div>
+
+
+
+### How can I report a bug in Snap?
+
+Found a bug in Snap? Please create a ticket on our
+[issue tracker.](http://github.com/snapframework/snap-core/issues)
+
+
+### Is anyone using Snap in production?
+
+Yes! Here is a list of sites that we know of that use Snap. Let us know if
+you know of others:
+
+ - [http://darcsden.com](Darcsden) is a nifty github-like source
+ code hosting site for darcs.
+
+ - [http://snapframework.com](http://snapframework.com) (this site)
+
+ - [http://ego.fm ](http://ego.fm )
+
+
+### Where's the high-level functionality?
+
+Our goal is for Snap to be a very fast, stable, *high-level* web framework at
+or above the same level of abstraction as frameworks like Ruby on Rails,
+Django, etc. During early planning and development we concluded that to
+accomplish this goal we needed to build our own web server and API to interface
+with it. This was an unanticipated detour, and we will resume working on
+higher-level functionality when the core has stabilized.
+
+
+### Why can't I install Snap?
+
+First, make sure you have `"$HOME/.cabal/bin"` at the beginning of your path.
+
+You may have an old version of Cabal. Try running "`cabal update && cabal
+install Cabal`". After this, "`cabal --version`" should say that you're using
+version 1.8.0.4 of the Cabal library or higher. After you do this, try
+installing Snap again.
+
+If that doesn't work, and you're getting an error that mentions `monads-fd` or
+`transformers`, try running "`cabal install --reinstall monads-fd`"
+(or `transformers`).
+
+If you're still having trouble, please email our [mailing
+list](http://mailman-mail5.webfaction.com/listinfo/snap) or contact us on our
+[IRC channel](http://webchat.freenode.net/?channels=snapframework&uio=d4)
+(`#snapframework` on [freenode](http://freenode.net/).
+
+
+### How do I get the libev backend working?
+
+To install Snap's [libev](http://software.schmorp.de/pkg/libev.html) backend,
+ensure you have the `libev` development libraries installed on your system and
+pass the `-flibev` flag to `cabal` when you install `snap-server`:
+
+~~~~~~ {.shell}
+$ cabal install snap-server -flibev
+~~~~~~
+
+If you get an undefined symbol "`EVFLAG_SIGNALFD`" then you'll need to
+install the latest [libev](http://software.schmorp.de/pkg/libev.html)
+from [source](http://dist.schmorp.de/libev/).
+
+
+### How can I help?
+
+##### Use Snap to build real websites.
+
+This is perhaps the best way to help. Let us know what issues you encounter
+and work on fixing the ones you care about most. If you are unable to fix a
+problem, you can still help by writing an automated test case that detects the
+problem.
+
+
+##### Develop automated memory leak and performance regression testing.
+
+Currently our top priority is working out correctness and performance issues in
+the server. We have a CI build server that automatically runs all our test
+cases, but we don't have an automated system to test for performance and memory
+leaks. This would be a very helpful addition.
+
+
+##### Improve test cases and code coverage.
+
+While not an exotic task, expanding our test suite can contribute significantly
+to the stability of the project.
+
+
+##### Improve documentation and tutorials.
+
+It's easy for documentation to get out of date. We try to keep it up-to-date,
+but we can always use more eyes to catch things that slip through the cracks.
+
+
+</div>
diff --git a/templates/faq.tpl b/templates/faq.tpl
index 60fc05e..024e5db 100644
--- a/templates/faq.tpl
+++ b/templates/faq.tpl
@@ -1,92 +1,8 @@
-<apply template="page">
+<static>
<bind tag="subtitle">: FAQ</bind>
- <static>
- <div class="singlecolumn">
- <h2>Frequently Asked Questions</h2>
- <ol>
- <li><a href="#issue-tracker">How can I report a bug in Snap?</a></li>
- <li><a href="#live-sites">Is anyone using Snap in production?</a></li>
- <li><a href="#high-level">Where's the high-level functionality?</a></li>
- <li><a href="#install">Why can't I install Snap?</a></li>
- <li><a href="#libev">How do I get the libev backend working?</a></li>
- <li><a href="#help">How can I help?</a></li>
- </ol>
-
- <h3 id="issue-tracker">How can I report a bug in Snap?</h3>
-
- <p>Found a bug in Snap? Please create a ticket on our <a
- href="http://github.com/snapframework/snap-core/issues";>issue
- tracker.</a></p>
-
- <h3 id="live-sites">Is anyone using Snap in production?</h3>
-
- <p>Yes! Here is a list of sites that we know of that use Snap. Let us
- know if you know of others</p>
-
- <ul>
- <li><a href="http://snapframework.com";>http://snapframework.com</a>
(this site)</li>
- <li><a href="http://darcsden.com";>http://darcsden.com</a></li>
- <li><a href="http://ego.fm";>http://ego.fm</a></li>
- </ul>
-
- <h3 id="high-level">Where's the high-level functionality?</h3>
-
- <p>Our goal is for Snap to be a very fast, stable, <em>high-level</em> web
- framework at or above the same level of abstraction as frameworks like Ruby
- on Rails, Django, etc. During early planning and development we concluded
- that to accomplish this goal we needed to build our own web server and API
- to interface with it. This was an unanticipated detour, and we will resume
- working on higher-level functionality when the core has stabilized.</p>
-
- <h3 id="install">Why can't I install Snap?</h3>
-
- <p>First, make sure you have "$HOME/.cabal/bin" at the beginning of your
- path.</p>
-
- <p>You may have an old version of Cabal. Try running "<code>cabal update
- && cabal install Cabal</code>". After this, "<code>cabal
- --version</code>" should say that you're using version 1.8.0.4 of the
- Cabal library or higher. After you do this try installing Snap again.</p>
-
- <p>If that didn't work, and you're getting an error that mentions
- monads-fd or transformers, try running "<code>cabal install --reinstall
- monads-fd</code>" (or transformers).</p>
-
- <h3 id="libev">How do I get the libev backend working?</h3>
-
- <p><code>cabal install snap-server -flibev</code></p>
-
- <p>If you get an undefined symbol 'EVFLAG_SIGNALFD' then you'll need to
- install the latest <a
href="http://software.schmorp.de/pkg/libev.html";>libev</a>
- from <a href="http://dist.schmorp.de/libev/";>source</a>.</p>
-
- <h3 id="help">How can I help?</h3>
-
- <h5>Use Snap to build real websites.</h5>
-
- <p>This is perhaps the best way to help. Let us know what issues you
- encounter and work on fixing the ones you care about most. If you are
- unable to fix a problem, you can still help by writing an automated test
- case that detects the problem.</p>
-
- <h5>Develop automated memory leak and performance regression testing.</h5>
-
- <p>Currently our top priority is working out correctness and performance
- issues in the server. We have a CI build server that automatically runs
- all our test cases, but we don't have an automated system to test for
- performance and memory leaks. This would be a very helpful addition.</p>
-
- <h5>Improve test cases and code coverage.</h5>
-
- <p>While not an exotic task, expanding our test suite can contribute
- significantly to the stability of the project.</p>
-
- <h5>Improve documentation and tutorials.</h5>
-
- <p>It's easy for documentation to get out of date. We try to keep it
- up-to-date, but we can always use more eyes to catch things that slip
- through the cracks.</p>
-
- </div>
- </static>
-</apply>
+ <apply template="page">
+ <div class="singlecolumn">
+ <markdown file="faq.md"/>
+ </div>
+ </apply>
+</static>
-----------------------------------------------------------------------
hooks/post-receive
--
snap-website
_______________________________________________
Snap mailing list
[email protected]
http://mailman-mail5.webfaction.com/listinfo/snap
