documentation about Building

[monperrus]

hi @davidbannon

I'm building tomboy-ng and would like to improve https://github.com/tomboy-notes/tomboy-ng/wiki/Building-tomboy-ng.

how to modify it?

Thanks!

--Martin

[davidbannon]

Wow, that would be great Martin !
(am I right in saying you are a Linux user ?)

Should be easy, the content is in markdown, specifically the github dialect. And thats what tomboy-ng imports and exports. So download the wiki, import that page into a tomboy-ng note, edit, export as markdown and (somehow) push back up to github. In detail -

Download the wiki, this will pull a complete copy of the markdown content -
$> git clone https://github.com/tomboy-notes/tomboy-ng.wiki.git

Import into tomboy-ng
$> tomboy-ng -m tomboy-ng.wiki/Building-tomboy-ng.md
Click the tomboy-ng tray icon, it should appear as the first note in you list there.

Export to md
From within the note when you are done, click tools button, Export -> Export Markdown
and save it over the original.

Upload ?
Now, this is where it gets interesting. I cannot see how we would trigger a pull request against the wiki. The (last resort) fall back position would be for you to email that markdown file to me but further research is indicated.

The git clone command I quoted is for a http download, that is, by its nature, read only. A ssh download, if github knows about your ssh keys and your local git is so configured would be -

$> git clone git://github.com/tomboy-notes/tomboy-ng.wiki.git

But for the subsequent upload to work, I'd need to give you write access to the repo. And I cannot, easily, find a way to do that. The tomboy-ng and tomboy-ng.wiki.git are different repos. I'd be very surprised if its not possible. I'll do some more digging ....

Davo

[monperrus]

I'd need to give you write access to the repo. And I cannot, easily, find a way to do that. The tomboy-ng and tomboy-ng.wiki.git are different repos. I'd be very surprised if its not possible.

yes it's a problem.

plus one cannot make a PR on the wiki repo.

This is why I don't use github integrated wikis and either use a doc folder in the repo and a separate wiki repo.

thanks!

[davidbannon]

Well, I have given up ! Quite a lot of searching, even stumbled across your footprints, but no answers. I was hoping that the new, fine grain token Github now use would would list wiki access along with the very large list of functions it does support. But, incredibly, no !

So, considering, as you suggested, a 'wiki' tree within the main repo, maybe the main page stays where it is and it references pages in the main, already do that with some images for example.

Somewhat disappointed !

Davo