devdocs/lib/docs/scrapers/django.rb

module Docs
  class Django < FileScraper
    self.name = 'Django'
    self.type = 'sphinx'
    self.root_path = 'index.html'
    self.links = {
      home: 'https://www.djangoproject.com/',
      code: 'https://github.com/django/django'
    }

    html_filters.push 'django/entries', 'sphinx/clean_html', 'django/clean_html'
    text_filters.push 'django/fix_urls'

    options[:container] = '#bd'

    options[:skip] = %w(
      contents.html
      genindex.html
      py-modindex.html
      glossary.html
      search.html
      intro/whatsnext.html)

    options[:skip_patterns] = [
      /\Afaq\//,
      /\Ainternals\//,
      /\Amisc\//,
      /\Areleases\//,
      /\A_/,
      /flattened\-index\.html/]

    options[:attribution] = <<-HTML
      &copy; Django Software Foundation and individual contributors<br>
      Licensed under the BSD License.
    HTML

    version '4.0' do
      self.release = '4.0'
      self.base_url = 'https://docs.djangoproject.com/en/4.0/'
    end

    version '3.2' do
      self.release = '3.2'
      self.base_url = 'https://docs.djangoproject.com/en/3.2/'
    end

    version '3.1' do
      self.release = '3.1.4'
      self.base_url = 'https://docs.djangoproject.com/en/3.1/'
    end

    version '3.0' do
      self.release = '3.0.11'
      self.base_url = 'https://docs.djangoproject.com/en/3.0/'
    end

    version '2.2' do
      self.release = '2.2.17'
      self.base_url = 'https://docs.djangoproject.com/en/2.2/'
    end

    version '2.1' do
      self.release = '2.1.15'
      self.base_url = 'https://docs.djangoproject.com/en/2.1/'
    end

    version '2.0' do
      self.release = '2.0.13'
      self.base_url = 'https://docs.djangoproject.com/en/2.0/'
    end

    version '1.11' do
      self.release = '1.11.29'
      self.base_url = 'https://docs.djangoproject.com/en/1.11/'
    end

    version '1.10' do
      self.release = '1.10.8'
      self.base_url = 'https://docs.djangoproject.com/en/1.10/'
    end

    version '1.9' do
      self.release = '1.9.13'
      self.base_url = 'https://docs.djangoproject.com/en/1.9/'
    end

    version '1.8' do
      self.release = '1.8.18'
      self.base_url = 'https://docs.djangoproject.com/en/1.8/'
    end

    def get_latest_version(opts)
      doc = fetch_doc('https://docs.djangoproject.com/', opts)
      doc.at_css('#doc-versions > li.current > span > strong').content
    end
  end
end