search

pysal / notebooks

jupyter/ipython notebooks demonstrating PySAL functionality
53 stars 38 forks source link

[WIP] add intro draft #76

Open knaaptime opened 4 years ago

knaaptime commented 4 years ago

here's a start on the intro. my intent was to describe a bit of the motivation for the book project and use serge's paper to give a bit of background on the current structure. let me know if you'd like to take it in another direction (or if there are details I borked) and i can keep plugging away

knaaptime commented 4 years ago

oops--i'd intented to replace that first #PySAL heading with something more descriptive

knaaptime commented 4 years ago

is it possible to reorder the chapters so they follow the same outline described here (lib -> explore -> viz -> model) ?

not that it's necessarily the perfect sequence, but it seems to me we should put lib first?

darribas commented 4 years ago

As for the re-ordering of the chapters, it's definitely posible though it'd take a bit of refactoring of the code. We currently simply pull the folders in the order they appear when downloaded:

https://github.com/pysal/notebooks/blob/master/lib/build.py#L150

I'm not sure what the most straightforward way would be to re-arrange as desired in an automated way. PRs most welcome :-)

sjsrey commented 4 years ago

As for the re-ordering of the chapters, it's definitely posible though it'd take a bit of refactoring of the code. We currently simply pull the folders in the order they appear when downloaded:

https://github.com/pysal/notebooks/blob/master/lib/build.py#L150

I'm not sure what the most straightforward way would be to re-arrange as desired in an automated way. PRs most welcome :-)

Would it be possible to change the ordering by editing https://github.com/pysal/notebooks/blob/master/docs/_data/toc.yml ?

darribas commented 4 years ago

Yes, you could change it there but everything in docs is automatically built by lib/build.py so you'd have to make a manual edit everytime it gets built. We should probably think of a way to insert it when the toc is being built...