Comments (9)
@ChicoXYC , when you make examples/ screenshots, please use this repository if possible. For jupyter notebooks, you can pick one from: https://github.com/hupili/python-for-data-and-media-communication
from python-for-data-and-media-communication-gitbook.
@ChicoXYC , please keep the following snippet in the footer of every chapter. I added it to week 01 as an example.
------
If you have any questions, or seek for help troubleshotting, please [create an issue here](https://github.com/hupili/python-for-data-and-media-communication-gitbook/issues/new)
from python-for-data-and-media-communication-gitbook.
@ChicoXYC Just some personal suggestions for you review. 1) can you explain a little bit further why we should preview Jupyter notebook on NBview? Are there any relationship with Github? For a new learner, I think it will be confusing.
2)Can you show how to create an index file in repository? If students don't want to just copy the example, is it possible to show them why (why we need to create an index file? Why is it necessary?) and how? (the procedures of creating an index file)
from python-for-data-and-media-communication-gitbook.
Maybe better for me to explain the concept and @ChicoXYC can add concrete examples and merge my explanations into the open book.
-
One can directly preview a Python notebook on GitHub. However, GitHub prohibits Javascript execution for security reasons. If you have interactive chart, e.g. from
echart
,plotly
, those will not render on GitHub. NBViewer supports javascript and it is the first free online tool to preview Python notebook, so we recommend it. For concrete examples of dynamic charts, @ChicoXYC can find one notebook from our project archive: https://github.com/data-projects-archive . -
Basically,
index.html
is the default file served by the web server. So it is equivalent to visitexample.com
andexample.com/index.html
. Naming your file asindex.html
can lead to this more concise notation in browser's address bar and in communication campaigns -- the naming in the world of web is usually the shorter the better. More explanations are here: https://en.wikipedia.org/wiki/Webserver_directory_index
from python-for-data-and-media-communication-gitbook.
@hupili That will be more clear!!
from python-for-data-and-media-communication-gitbook.
update @hupili thanks @rippleYJH
from python-for-data-and-media-communication-gitbook.
I added two optional chapters. Since it is optional, those pointers should be enough for people who are motivated and interested. We can come back to add more detailed instructions when time permits. FYI.
Two sections:
- Add sub-path to gh-pages hosted domain
- Bind custom domain to your gh-pages repo
@ChicoXYC Here are the remaining TODOs:
- Fix the section headings and check the TOC if the rendered result looks normal.
- Full proof-reading.
Then we can release to the precamp group.
from python-for-data-and-media-communication-gitbook.
- https://github.com/hupili/python-for-data-and-media-communication-gitbook/blob/master/notes-week-00.md#why-we-should-preview-jupyter-notebook-on-nbviewer -- Not only give the NBViewer link but also give the original GitHub link, so they know what works and what not.
-
Talking about this function, GitHub is like a cloud disk, which is similar to Google Drive,OneDrive.
-- Chinese comma. - https://github.com/hupili/python-for-data-and-media-communication-gitbook/blob/master/notes-week-00.md#step-4-commit--publish -- need to re-take the screenshot. The code in
meta
tag is wrong. - https://github.com/hupili/python-for-data-and-media-communication-gitbook/blob/master/notes-week-00.md#use-github-issue-tracker-as-a-discussion-forum -- always give URLs if the screenshot is from public domain. In this way, they can see the principle in action. The same for the commit message and all other similar screenshots. Please apply this principle in future work.
from python-for-data-and-media-communication-gitbook.
@hupili Update, thanks for your patient instruction.
from python-for-data-and-media-communication-gitbook.
Related Issues (20)
- datetime conversion HOT 1
- failed to open url with urllib.request HOT 6
- TODO marks in the source code HOT 4
- how to jump to next page in centaline property HOT 6
- termtosvg may be useful for ch00 on Terminal/ Shell
- Fix per-chapter TOC in exported HTML/PDF
- clustering - Kmeans, Agglomerative, and DBSCAN HOT 3
- How to put User-Defined Image into the scatter diagram HOT 5
- How to merge grouped data HOT 3
- Add week 15 related case
- Some problems about return 'None' HOT 2
- prevent feedparser overwrite when scrape rss feed HOT 6
- ValueError: list.remove(x): x not in list HOT 1
- How to download CSV from GitHub HOT 1
- Test how to raise a quesion
- How to print csv file in Jupyter notebook HOT 3
- How to scrape all urls in one article HOT 2
- Chromedriver is not in the Path HOT 11
- cannot import Bar from pyecharts HOT 10
- Common methods to exit
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 python-for-data-and-media-communication-gitbook.