Comments (4)
@zhongxiang117
*.gem
is only for this repo local build theme use!
*.whl
is only for this repo download origin sphinx_rtd_theme
theme use!
About jekyll-remote-theme
gem plugin, you can see the source code for witch file is included
_includes
_layouts
_sass
assets
No _data
dir and any more files!
from jekyll-rtd-theme.
global-gitignore is not recommends
from jekyll-rtd-theme.
Keep update the theme, github pages use remote_theme and local use ruby gem
Blow option for remote-theme method compress css!
sass:
style: compressed
from jekyll-rtd-theme.
You may misunderstand what I am saying.
Let we think a scenario, suppose a new user wants to use this theme to support his/her blog or to release documents. As usual, s/he needs to Fork or Download this theme first, in either way, s/he has the default .gitignore
in his/her repository.
And probably, s/he may be not aware those git-ignore
entries.
It has great possible that s/he may need to pre-check their contents before they really online-git-publishing.
It works well in their local
building.
However, if it exists a file happening to match git-ignore rules, then what will happen in next?
Those ignored files will not be published to their online git repository.
Therefore, it will cause differences between the local repository and remote git repository.
This is the Potential Issue that I am talking about.
It is not about how do you set your own .gitignore
for developments, it is about the hidden problem between user's local
and git-remote
repository.
This package is not a one time build-to-use package, the user needs to constantly make relations between their local
and git-remote
repositories, thus please do not help user set those .gitignore
options.
And I guess it also is the reason that that you removed *.html
option in the early version's.
The global-gitignore
is only a suggestion for you to make your local repository works like your current settings.
So, I still strongly suggest to remove all contents in offical package .gitignore
file.
from jekyll-rtd-theme.
Related Issues (20)
- custom png files
- Sidebar sort order
- Feature request: respect in show_sorted in side bar
- "Edit on GitHub" link confusion
- Custom page ending and logo
- question - pages opt out HOT 1
- Question about Toast Cards
- Toast Cards Cached
- Feature request : Turn off the sidebar when printing HOT 1
- Mathjax isn't work
- Quick start links are dead (404) HOT 1
- Requesting Guidance on Locally Modifying Style Elements in rundocs / jekyll-rtd-theme HOT 2
- Performance improvements for generating the sidebar
- "Header 1" level headings are not included in Index pane (Test sample site shows this)
- Bug
- anyway to support asciidoctor as well?
- How to modify CSS
- Error
- Dark mode?
- Liquid Exception: undefined method `tainted?' for nil:NilClass in assets/404.liquid
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 jekyll-rtd-theme.