Comments (6)
seems GitBook version 2 no longer has a gitbook
cli tool to generate html, so we can't upgrade unless we buy into their platform (and pay their fees). so we're stuck with GitBook version 1 or we can migrate to mdBook which is a Rust implementation of the same functionality, but that's separate from this issue (where we could do the same by disabling their index
preprocessor (see mdBook config)).
from handbook.scuttlebutt.nz.
@christianbundy https://toolchain.gitbook.com/config.html#structure
from handbook.scuttlebutt.nz.
@christianbundy i'm not sure what the best way is. but to start, we could make the link to contributing.md
more prominent in README.md
, where contributing.md
should try to describe what the GitBook is about and how to contribute. i'm also happy if we changed the current README.md
to something like index.md
as the main landing page for the deployed GitBook, then made a separate README.md
which is the landing page for when viewing the code.
from handbook.scuttlebutt.nz.
@ahdinosaur Thanks! Do you think that we should mess with those settings to have a separate readme, or should I include information about ssb-handbook in the readme itself? I'm not sure what the goal of the gitbook is so I'm hesitant to make it self-referential unless that's the vibe we're going for.
from handbook.scuttlebutt.nz.
Hey @ahdinosaur this is my Doco Drive for this week, but I can't read the linked stuff as it seems to be in legacy.gitbook.com now?? and I'm not a member of this gitbook so how do I help/do things?
@christianbundy - I think part of the confusion, is that ssb-handbook is kind of the first front facing 'landing page' and for newbies there's so much information. I think Mikey's suggestion is pretty good!
from handbook.scuttlebutt.nz.
@marylychee https://scuttlebutt.nz is built from this GitHub repo anytime something is published to master, we use gitbook
as a way to write markdown and build html, but we use http://netlify.com/ to run npm run build
and host the html content inside _book
, so if you want to change anything on the website then a change to this GitHub repo will do the trick. hope that helps. ❤️
from handbook.scuttlebutt.nz.
Related Issues (20)
- Code of Conduct link broken HOT 1
- rename repo to scuttlebutt.nz HOT 2
- Delete merged branches HOT 1
- Broken links in FAQ HOT 3
- add Powersource's talk HOT 3
- Who can see all of the various names attached to your public key identity? HOT 2
- More clarity around degrees of separation and privacy/data HOT 4
- "Publish a file" shows how to create a text file, and then references loading an image HOT 1
- Update/improve section on deleting and resyncing your database HOT 1
- add Oasis client to handbook HOT 1
- Question about community forum and Ethereum hosted Pubs
- Broken hyperlinks in applications.md
- Stop recommending patchwork in the getting started guide HOT 2
- Documentation structure HOT 1
- quick start: add step for #new-people introduction HOT 4
- the thread link in multiple-devices.md throws a 502 HOT 2
- NZ? HOT 2
- add josiah's guides
- add nichoths's survival guide
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from handbook.scuttlebutt.nz.