metacrunch-mab2 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e58083a8b10b6796906050c64d31ed1e3b565b92
+  data.tar.gz: e76670a16196f8c9ab0d1ed7aa4be9592f6fe79d
+SHA512:
+  metadata.gz: 6facef45723b7ae6d4c7af8f6e32ddbc4ec9a34fa81e5b80e253556fe9b4ccfe2a2058c82f3874ba945c2fea59f8ef1188c8c6785460c93fec11356d77e7b801
+  data.tar.gz: 22a9eb459fd762b0a597bdb6472e3484dd8c5ec96fd28465ac07ec5907d0461aa1f49800f985fb68ed2fdc05fbc7a9466feeadb9125bfbb18a3c9f5ae6d6edd7

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+/Gemfile.lock
+/.yardoc
+/doc
+/*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - "2.2.2"

data/Gemfile

@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "metacrunch", ">= 2.1.0", github: "ubpb/metacrunch", branch: "master"
+
+gem "rake"
+gem "pry-byebug",    "~> 3.1.0"
+gem "rspec",         "~> 3.2.0"
+gem "benchmark-ips", "~> 2.1"
+
+# for benchmarking
+gem "mabmapper", github: "ubpb/mabmapper", branch: "master"

data/License.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 René Sprotte, Michael Sievers, Marcel Otto
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,5 @@
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/Readme.md

@@ -0,0 +1,6 @@
+# metacrunch-mab2
+
+[![Code Climate](https://codeclimate.com/github/ubpb/metacrunch-mab2/badges/gpa.svg)](https://codeclimate.com/github/ubpb/metacrunch-mab2)
+[![Build Status](https://travis-ci.org/ubpb/metacrunch-mab2.svg)](https://travis-ci.org/ubpb/metacrunch-mab2)
+
+Dokumentation folgt in Kürze...

data/benchmarks/mab2_document_parsing.rb

@@ -0,0 +1,24 @@
+require "metacrunch/mab2"
+require "benchmark/ips"
+
+require "mabmapper"
+require "mabmapper/aleph_mab_xml_engine"
+class EmptyMabmapperEngine < Mabmapper::Engine
+  document_class Mabmapper::MabXml::Document
+end
+
+Benchmark.ips do |x|
+  x.config(time: 5, warmup: 2)
+
+  @xml = File.read(File.join(Pathname.new(__dir__), "..", "spec", "assets", "aleph_mab_xml", "file1.xml"))
+
+  x.report("mabmapper") do
+    @document = EmptyMabmapperEngine.new.process("dummy.xml", @xml)
+  end
+
+  x.report("metacrunch") do
+    @document = Metacrunch::Mab2::Document.from_aleph_mab_xml(@xml)
+  end
+
+  x.compare!
+end

data/benchmarks/mab2_document_query.rb

@@ -0,0 +1,34 @@
+require "metacrunch/mab2"
+require "benchmark/ips"
+
+Benchmark.ips do |x|
+  x.config(time: 5, warmup: 2)
+
+  @xml      = File.read(File.join(Pathname.new(__dir__), "..", "spec", "assets", "aleph_mab_xml", "file1.xml"))
+  @document = Metacrunch::Mab2::Document.from_aleph_mab_xml(@xml)
+
+  x.report("reference") do
+    a = []
+
+    datafields_struct = @document.send(:datafields_struct)
+    datafields_set    = datafields_struct["PPE"]
+    datafields        = datafields_set.to_a
+
+    datafields.each do |datafield|
+      subfields_struct = datafield.send(:subfields_struct)
+      subfields_set    = subfields_struct["p"]
+      subfields        = subfields_set.to_a
+
+      subfields.each do |subfield|
+        a << subfield.value
+      end
+    end
+  end
+
+  x.report("implementation") do
+    @document.datafields("PPE").subfields("p").values
+  end
+
+  x.compare!
+end
+

data/lib/metacrunch/mab2/aleph_mab_xml_document_factory.rb

@@ -0,0 +1,89 @@
+require "htmlentities"
+require "ox"
+require_relative "./document"
+
+module Metacrunch
+  module Mab2
+    class AlephMabXmlDocumentFactory
+
+      def initialize(aleph_mab_xml)
+        @aleph_mab_xml = aleph_mab_xml
+      end
+
+      def to_document
+        @document ||= Parser.new.parse(@aleph_mab_xml)
+      end
+
+    private
+
+      class Parser < Ox::Sax
+        def parse(io_or_string)
+          # initialize state machine
+          @in_controlfield = @in_datafield = @in_subfield = false
+
+          @controlfield = @datafield = @subfield = nil
+          @document = Document.new
+          @html_entities_coder = HTMLEntities.new
+
+          io = io_or_string.is_a?(IO) ? io_or_string : StringIO.new(io_or_string)
+
+          # convert_special tells ox to convert some html entities already during
+          # parsing, which minifies the amount of entities we have to decode ourself
+          Ox.sax_parse(self, io, convert_special: true)
+
+          return @document
+        end
+
+        def start_element(name)
+          if name == :subfield
+            @in_subfield = true
+            @subfield = Document::Datafield::Subfield.new
+          elsif name == :datafield
+            @in_datafield = true
+            @datafield = Document::Datafield.new
+          elsif name == :controlfield
+            @in_controlfield = true
+            @controlfield = Document::Controlfield.new
+          end
+        end
+
+        def end_element(name)
+          if @in_subfield
+            @in_subfield = false
+            @datafield.add_subfield(@subfield)
+          elsif @in_datafield
+            @in_datafield = false
+            @document.add_datafield(@datafield)
+          elsif @in_controlfield
+            @in_controlfield = false
+            @document.add_controlfield(@controlfield)
+          end
+        end
+
+        def attr(name, value)
+          if @in_subfield
+            @subfield.code = value if name == :code
+          elsif @in_datafield
+            if name == :tag
+              @datafield.tag = value
+            elsif name == :ind1
+              @datafield.ind1 = value
+            elsif name == :ind2
+              @datafield.ind2 = value
+            end
+          elsif @in_controlfield
+            @controlfield.tag = value if name == :tag
+          end
+        end
+
+        def text(value)
+          if @in_subfield
+            @subfield.value = value.include?("&") ? @html_entities_coder.decode(value) : value
+          elsif @in_controlfield
+            @controlfield.values = value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/metacrunch/mab2/cli.rb

@@ -0,0 +1 @@
+# TODO

data/lib/metacrunch/mab2/document/controlfield.rb

@@ -0,0 +1,79 @@
+module Metacrunch
+  module Mab2
+    class Document
+      class Controlfield
+
+        attr_accessor :tag
+
+        def initialize(tag = nil, values = [])
+          self.tag    = tag
+          self.values = values
+        end
+
+        def tag=(value)
+          @tag = value.to_s if value
+        end
+
+        #
+        # Setter for the control field values. Values can be given as String or
+        # as an Array.
+        #
+        # @param [String, Array] values for the control field as a String or Array.
+        #   In case of String the MAB2 delimiter/placeholder | is respected. In case
+        #   of an Array every element is converted into a String. Empty strings are
+        #   converted into nil. Array values that are longer than one character will
+        #   raise an ArgumentError.
+        #
+        # @example Add control field using String values
+        #   add_control_field("050", "a|b||")
+        #
+        # @example Add control field using Array
+        #   add_control_field("050", ["a", nil, "b", nil, nil])
+        #
+        def values=(values)
+          @values = case values
+            when String then string2values(values)
+            when Array  then array2values(values)
+            when nil    then []
+            else
+              raise ArgumentError, "expecting a String or Array, but got #{values}"
+            end
+        end
+
+        #
+        # @return [Array<String>]
+        #
+        def values
+          @values
+        end
+
+        #
+        # @param [int] index
+        # @return [Array<String>] value at given index
+        #
+        def at(index)
+          @values.at(index)
+        end
+
+      private
+
+        def string2values(string)
+          string.chars.to_a.map{ |e| (e=="|") ? nil : e }
+        end
+
+        def array2values(values)
+          values.map do |v|
+            if v.present?
+              v = v.to_s
+              raise ArgumentError, "invalid value of controlfield #{tag}: #{values}" if v.length > 1
+              v
+            else
+              nil
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/metacrunch/mab2/document/datafield.rb

@@ -0,0 +1,54 @@
+module Metacrunch
+  module Mab2
+    class Document
+      class Datafield
+
+        attr_accessor :tag
+        attr_accessor :ind1, :ind2
+
+        def initialize(tag = nil, ind1:nil, ind2:nil)
+          @tag  = tag
+          @ind1 = ind1
+          @ind2 = ind2
+        end
+
+        # ------------------------------------------------------------------------------
+        # Sub fields
+        # ------------------------------------------------------------------------------
+
+        #
+        # @return [Hash{String => Metacrunch::Mab2::Document::Datafield::Subfield::Set}]
+        # @private
+        #
+        def subfields_struct
+          @subfields_struct ||= {}
+        end
+        private :subfields_struct
+
+        #
+        # Returns the sub field matching the given code.
+        #
+        # @param [String] code of the sub field
+        # @return [Metacrunch::Mab2::Document::Datafield::Subfield::Set] sub field with the given code. The set
+        #  is empty if the sub field doesn't exists.
+        #
+        def subfields(code)
+          subfields_struct[code] || Subfield::Set.new
+        end
+
+        #
+        # Adds a new sub field.
+        #
+        # @param [Metacrunch::Mab2::Document::Datafield::Subfield] subfield
+        #
+        def add_subfield(subfield)
+          subfield_set  = subfields(subfield.code)
+          subfield_set << subfield
+
+          subfields_struct[subfield.code] = subfield_set
+        end
+
+      end
+    end
+  end
+end

data/lib/metacrunch/mab2/document/datafield_set.rb

@@ -0,0 +1,47 @@
+module Metacrunch
+  module Mab2
+    class Document
+      class Datafield
+        class Set
+          include Enumerable
+
+          def initialize(datafields = [])
+            @datafields = datafields
+          end
+
+          def each
+            block_given? ? @datafields.each { |_datafield| yield _datafield } : to_enum
+          end
+
+          def <<(datafield)
+            @datafields << datafield
+          end
+
+          def concat(datafield_set)
+            @datafields.concat(datafield_set.to_a)
+          end
+
+          def to_a
+            @datafields
+          end
+
+          def empty?
+            @datafields.empty?
+          end
+
+          # @return [Metacrunch::Mab2::Document::Datafield::Subfield::Set]
+          def subfields(name)
+            set = Subfield::Set.new
+
+            @datafields.each do |datafield|
+              set.concat(datafield.subfields(name))
+            end
+
+            set
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/metacrunch/mab2/document/subfield.rb

@@ -0,0 +1,20 @@
+module Metacrunch
+  module Mab2
+    class Document
+      class Datafield
+        class Subfield
+
+          attr_accessor :code
+          attr_accessor :value
+
+          def initialize(code = nil, value = nil)
+            @code  = code
+            @value = value
+          end
+
+        end
+      end
+    end
+  end
+end
+

data/lib/metacrunch/mab2/document/subfield_set.rb

@@ -0,0 +1,42 @@
+module Metacrunch
+  module Mab2
+    class Document
+      class Datafield
+        class Subfield
+          class Set
+            include Enumerable
+
+            def initialize(subfields = [])
+              @subfields = subfields
+            end
+
+            def each
+              block_given? ? @subfields.each { |_subfield| yield _subfield } : to_enum
+            end
+
+            def <<(subfield)
+              @subfields << subfield
+            end
+
+            def concat(subfield_set)
+              @subfields.concat(subfield_set.to_a)
+            end
+
+            def to_a
+              @subfields
+            end
+
+            def empty?
+              @subfields.empty?
+            end
+
+            def values
+              @subfields.map{ |subfield| subfield.value }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/metacrunch/mab2/document.rb

@@ -0,0 +1,106 @@
+module Metacrunch
+  module Mab2
+    class Document
+      require_relative "./document/controlfield"
+      require_relative "./document/datafield"
+      require_relative "./document/datafield_set"
+      require_relative "./document/subfield"
+      require_relative "./document/subfield_set"
+
+      # ------------------------------------------------------------------------------
+      # Parsing
+      # ------------------------------------------------------------------------------
+
+      #
+      # @param [String] xml repesenting a MAB document in Aleph MAB XML format
+      # @return [Metacrunch::Mab2::Document]
+      #
+      def self.from_aleph_mab_xml(xml)
+        AlephMabXmlDocumentFactory.new(xml).to_document
+      end
+
+      # ------------------------------------------------------------------------------
+      # Control fields
+      # ------------------------------------------------------------------------------
+
+      #
+      # @return [Hash{String => Metacrunch::Mab2::Document::Controlfield}]
+      # @private
+      #
+      def controlfields_struct
+        @controlfields_struct ||= {}
+      end
+      private :controlfields_struct
+
+      #
+      # Returns the control field matching the given tag.
+      #
+      # @param [String] tag of the control field
+      # @return [Controlfield, nil] control field with the given tag. Is nil
+      #  if the control field doesn't exists.
+      #
+      def controlfield(tag)
+        controlfields_struct[tag]
+      end
+
+      #
+      # Adds a new control field.
+      #
+      # @param [Metacrunch::Mab2::Document::Controlfield] controlfield
+      #
+      def add_controlfield(controlfield)
+        controlfields_struct[controlfield.tag] = controlfield
+      end
+
+      # ------------------------------------------------------------------------------
+      # Data fields
+      # ------------------------------------------------------------------------------
+
+      #
+      # @return [Hash{String => Metacrunch::Mab2::Document::Datafield::Set}]
+      # @private
+      #
+      def datafields_struct
+        @datafields_struct ||= {}
+      end
+      private :datafields_struct
+
+      #
+      # Returns the data fields matching the given tag and ind1/ind2.
+      #
+      # @param [String] tag of the data field
+      # @param [String, nil] ind1 filter for ind1. Can be nil to match any.
+      # @param [String, nil] ind2 filter for ind2. Can be nil to match any.
+      # @return [Metacrunch::Mab2::Document::Datafield::Set] data field with the given tag and ind1/ind2.
+      #  The set is empty if a matching field with the tag and/or ind1/ind2 doesn't exists.
+      #
+      def datafields(tag, ind1: nil, ind2: nil)
+        set = datafields_struct[tag] || Datafield::Set.new
+        return set if set.empty?
+
+        if ind1 || ind2
+          filtered_datafields = set.select do |_datafield|
+            (!ind1 || _datafield.ind1 == ind1) && (!ind2 || _datafield.ind2 == ind2)
+          end
+          
+          Datafield::Set.new(filtered_datafields)
+        else
+          set
+        end
+      end
+
+      #
+      # Adds a new data field.
+      #
+      # @param [Metacrunch::Mab2::Document::Datafield] datafield
+      #
+      def add_datafield(datafield)
+        datafield_set  = datafields(datafield.tag)
+        datafield_set << datafield
+
+        datafields_struct[datafield.tag] = datafield_set
+      end
+
+    end
+  end
+end

data/lib/metacrunch/mab2/version.rb

@@ -0,0 +1,5 @@
+module Metacrunch
+  module Mab2
+    VERSION = "1.0.0"
+  end
+end

data/lib/metacrunch/mab2.rb

@@ -0,0 +1,16 @@
+require "metacrunch"
+require "ox"
+require "htmlentities"
+
+begin
+  require "pry"
+rescue LoadError ; end
+
+module Metacrunch
+  module Mab2
+    require_relative "./mab2/version"
+    require_relative "./mab2/document"
+    require_relative "./mab2/cli"
+    require_relative "./mab2/aleph_mab_xml_document_factory"
+  end
+end

data/lib/metacrunch_plugin.rb

@@ -0,0 +1 @@
+require "metacrunch/mab2"

data/metacrunch-mab2.gemspec

@@ -0,0 +1,23 @@
+require File.expand_path("../lib/metacrunch/mab2/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.authors       = ["René Sprotte", "Michael Sievers", "Marcel Otto"]
+  s.email         = "r.sprotte@ub.uni-paderborn.de"
+  s.summary       = %q{MAB2 tools for metacrunch}
+  s.description   = s.summary
+  s.homepage      = "http://github.com/ubpb/metacrunch-mab2"
+  s.licenses      = ["MIT"]
+
+  s.files         = `git ls-files`.split($\)
+  s.executables   = s.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.name          = "metacrunch-mab2"
+  s.require_paths = ["lib"]
+  s.version       = Metacrunch::Mab2::VERSION
+
+  s.required_ruby_version = ">= 2.2.0"
+
+  s.add_dependency "metacrunch",   "~> 2.1"
+  s.add_dependency "htmlentities", "~> 4.3"
+  s.add_dependency "ox",           "~> 2.1"
+end

data/spec/assets/aleph_mab_xml/file1.xml

@@ -0,0 +1,210 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
+  <ListRecords>
+    <record>
+      <header>
+        <identifier>aleph-publish:000969442</identifier>
+      </header>
+      <metadata>
+        <record xmlns="http://www.ddb.de/professionell/mabxml/mabxml-1.xsd">
+          <leader>------M2.01200024------h</leader>
+          <controlfield tag="LDR">------M2.01200024------h</controlfield>
+          <controlfield tag="FMT">MH</controlfield>
+          <datafield tag="001" ind1="-" ind2="1">
+            <subfield code="a">HT014768063</subfield>
+          </datafield>
+          <datafield tag="002" ind1="a" ind2="1">
+            <subfield code="a">20060627</subfield>
+          </datafield>
+          <datafield tag="003" ind1="-" ind2="1">
+            <subfield code="a">20061121</subfield>
+          </datafield>
+          <controlfield tag="030">a|1uc||||||17</controlfield>
+          <datafield tag="036" ind1="a" ind2="1">
+            <subfield code="a">DE</subfield>
+          </datafield>
+          <datafield tag="037" ind1="b" ind2="1">
+            <subfield code="a">ger</subfield>
+          </datafield>
+          <controlfield tag="050">a|||||||||||||</controlfield>
+          <controlfield tag="051">m|||||||</controlfield>
+          <datafield tag="070" ind1="-" ind2="1">
+            <subfield code="a">290</subfield>
+          </datafield>
+          <datafield tag="070" ind1="b" ind2="1">
+            <subfield code="a">294</subfield>
+          </datafield>
+          <datafield tag="080" ind1="-" ind2="1">
+            <subfield code="a">60</subfield>
+          </datafield>
+          <datafield tag="100" ind1="-" ind2="1">
+            <subfield code="p">Kofler, Michael</subfield>
+            <subfield code="d">1967-</subfield>
+            <subfield code="9">(DE-588)121636763</subfield>
+          </datafield>
+          <datafield tag="104" ind1="a" ind2="1">
+            <subfield code="p">Plate, Jürgen</subfield>
+            <subfield code="9">(DE-588)124010938</subfield>
+          </datafield>
+          <datafield tag="331" ind1="-" ind2="1">
+            <subfield code="a">&lt;&lt;Das&gt;&gt; Linux für Studenten</subfield>
+          </datafield>
+          <datafield tag="359" ind1="-" ind2="1">
+            <subfield code="a">Michael Kofler ; Jürgen Plate</subfield>
+          </datafield>
+          <datafield tag="370" ind1="a" ind2="1">
+            <subfield code="a">Debian GNU-Linux 3.1r2 "Sarge"</subfield>
+          </datafield>
+          <datafield tag="410" ind1="-" ind2="1">
+            <subfield code="a">München [u.a.]</subfield>
+          </datafield>
+          <datafield tag="412" ind1="-" ind2="1">
+            <subfield code="a">Pearson Studium</subfield>
+          </datafield>
+          <datafield tag="425" ind1="a" ind2="1">
+            <subfield code="a">2006</subfield>
+          </datafield>
+          <datafield tag="433" ind1="-" ind2="1">
+            <subfield code="a">607 S. : Ill., graph. Darst.</subfield>
+          </datafield>
+          <datafield tag="437" ind1="-" ind2="1">
+            <subfield code="a">2 DVDs</subfield>
+          </datafield>
+          <datafield tag="451" ind1="-" ind2="1">
+            <subfield code="a">Scientific tools</subfield>
+          </datafield>
+          <datafield tag="512" ind1="-" ind2="1">
+            <subfield code="p">DVDs u.d.T.</subfield>
+            <subfield code="a">Debian GNU-Linux 3.1r2 "Sarge"</subfield>
+          </datafield>
+          <datafield tag="540" ind1="a" ind2="1">
+            <subfield code="a">978-3-8273-7205-5</subfield>
+            <subfield code="b">kart. : EUR 39.95</subfield>
+          </datafield>
+          <datafield tag="540" ind1="a" ind2="1">
+            <subfield code="a">3-8273-7205-4</subfield>
+          </datafield>
+          <datafield tag="902" ind1="-" ind2="1">
+            <subfield code="s">LINUX</subfield>
+            <subfield code="9">(DE-588)4337730-0</subfield>
+          </datafield>
+          <controlfield tag="SYS">000969442</controlfield>
+          <datafield tag="PPE" ind1="-" ind2="1">
+            <subfield code="p">Kofler, M.</subfield>
+            <subfield code="d">1967-</subfield>
+            <subfield code="9">(DE-588)121636763</subfield>
+          </datafield>
+          <datafield tag="PPE" ind1="-" ind2="1">
+            <subfield code="p">Kofler, Michaėlʹ</subfield>
+            <subfield code="d">1967-</subfield>
+            <subfield code="9">(DE-588)121636763</subfield>
+          </datafield>
+          <datafield tag="PPE" ind1="-" ind2="1">
+            <subfield code="p">Kofler, M.</subfield>
+            <subfield code="d">1967-</subfield>
+            <subfield code="9">(DE-588)121636763</subfield>
+          </datafield>
+          <datafield tag="PPE" ind1="-" ind2="1">
+            <subfield code="p">Kofler, Michaėlʹ</subfield>
+            <subfield code="d">1967-</subfield>
+            <subfield code="9">(DE-588)121636763</subfield>
+          </datafield>
+          <datafield tag="700" ind1=" " ind2=" ">
+            <subfield code="a">TWR</subfield>
+          </datafield>
+          <datafield tag="OWN" ind1=" " ind2=" ">
+            <subfield code="a">P0001</subfield>
+            <subfield code="n">466 - Paderborn: UB</subfield>
+          </datafield>
+          <datafield tag="655" ind1=" " ind2=" ">
+            <subfield code="y">Linux für Studenten</subfield>
+            <subfield code="t">VIEW</subfield>
+            <subfield code="u">http://digitool.hbz-nrw.de:1801/webclient/DeliveryManager?application=DIGITOOL-3&amp;owner=resourcediscovery&amp;custom_att_2=simple_viewer&amp;user=GUEST&amp;pid=2170987</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">OCR-TEXT: INHALTSVERZEICHNIS VORWORT 17 KAPITEL 1 WAS IST LINUX? 21 1.1 EINFHRUNG 22 1.2 DISTRIBUTIONEN 25 1.3 TRAUM UND WIRKLICHKEIT 29 1.4 HERKUNFT UND LIZENZ VON LINUX 31 KAPITEL 2 INSTALLATION 35 2.1 VORAUSSETZUNGEN 36 2.2 BERBLICK BER DEN INSTALLATIONSPROZESS 36 2.3 GRUNDLAGEN DER FESTPLATTENPARTITIONIERUNG 38 2.3.1 WAS SIND PARTITIONEN UND WOZU DIENEN SIE? 38 2.3.2 PARTITIONSTYPEN 38 2.3.3 PARTITIONIERUNG UND FORMATIERUNG 39 2.3.4 PARTITIONSNAMEN UNTER WINDOWS 39 2.3.5 PARTITIONSNAMEN UNTER LINUX 40 2.4 NEUPARTITIONIERUNG DER FESTPLATTE 41 2.4.1 NEUPARTITIONIERUNG UNTER WINDOWS 9X/ME 42 2.4.2 NEUPARTITIONIERUNG UNTER WINDOWS NT/2000/XP 44 2.5 START DER LINUX-INSTALLATION 45 2.6 PARTITIONIERUNG DER FESTPLATTE UNTER LINUX 47 2.6.1 ANZAHL UND GRE VON LINUX-PARTITIONEN 47 2.6.2 WELCHES DATEISYSTEM? 49 2.7 PAKETAUSWAHL 49 2.7.1 GRUNDKONFIGURATION 50 2.7.2 INSTALLATION DES BOOT-LOADERS 52 2.8 INSTALLATIONSVARIANTEN 53 2.8.1 INSTALLATIONSDISKETTEN ERZEUGEN 53 2.8.2 LINUX BER EINE NETZWERKVERBINDUNG INSTALLIEREN 53 2.8.3 NOTEBOOK-INSTALLATION 54 2.9 PROBLEME BEI DER INSTALLATION 55 2.9.1 HARDWARE-PROBLEME 55 2.9.2 DAS 1024-ZYLINDER-PROBLEM 56 2.9.3 TASTATURPROBLEME 56 2.10 PROBLEME NACH DER INSTALLATION 57 2.10.1 DER RECHNER KANN NICHT MEHR GESTARTET WERDEN 57 2.10.2 X/KDE/GNOME STARTET NICHT 59 2.10.3 DIE MAUS FUNKTIONIERT NICHT ODER NUR TEILWEISE 59 2.10.4 DIE TASTATUR FUNKTIONIERT NICHT 60 2.10.5 MENS ERSCHEINEN IN DER FALSCHEN SPRACHE 60 2.11 SYSTEMVERNDERUNGEN, ERWEITERUNGEN UND UPDATES 60 2.12 LINUX WIEDER ENTFERNEN 61 KAPITEL 3 LINUX-EINSTIEG 63 3.1 LINUX STARTEN UND BEENDEN 64 3.2 GRAFISCHE BENUTZEROBERFLCHEN (KDE UND GNOME) 67 3.2.1 KDE-SCHNELLEINSTIEG 67 3.2.2 GNOME-SCHNELLEINSTIEG 68 3.3 TASTATUR, MAUS UND ZWISCHENABLAGE 68 3.3.1 WICHTIGE TASTENKRZEL 68 3.3.2 EINGABE AUSLNDISCHER SONDERZEICHEN 70 3.3.3 VERWENDUNG DER MAUS 71 3.3.4 MAUSSTEUERUNG PER TASTATUR 72 3.3.5 ZWISCHENABLAGE 72 3.4 TEXTKONSOLEN UND SHELL-FENSTER 73 3.4.1 TEXTKONSOLEN 73</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">3.4.2 KONSOLENFENSTER (SHELL-FENSTER) 74 3.4.3 KOMMANDOS AUSFHREN 75 3.4.4 ARBEITEN ALS ROOT 77 3.5 UMGANG MIT DATEIEN UND VERZEICHNISSEN 78 3.5.1 DATEIEN 78 3.5.2 KOMMANDOS ZUR BEARBEITUNG VON DATEIEN 79 3.5.3 TEXTDATEIEN ANZEIGEN 80 3.5.4 TEXTEDITOREN 81 3.5.5 JOKERZEICHEN 82 3.5.6 KOMPLIKATIONEN BEI DER VERWENDUNG VON JOKERZEICHEN 83 3.5.7 VERSTECKTE DATEIEN 85 3.5.8 VERZEICHNISSE 85 3.5.9 FESTE UND SYMBOLISCHE LINKS 86 3.5.10 LINKS AUF PROGRAMME 88 3.6 ZUGRIFFSRECHTE, BENUTZER UND GRUPPENZUGEHRIGKEIT 88 3.6.1 ZUGRIFFSRECHTE AUF VERZEICHNISSE 90 3.6.2 SPEZIALBITS 91 3.6.3 BESITZER, GRUPPE UND ZUGRIFFSBITS NEUER DATEIEN 92 3.7 LINUX-VERZEICHNISSTRUKTUR, DEVICE-NAMEN 93 3.7.1 LINUX-VERZEICHNISSTRUKTUR (FILESYSTEM HIERARCHY STANDARD) 93 3.7.2 DEVICES 95 3.7.3 DATEITYPEN (MIME) 98 3.7.4 MAGIC-DATEIEN 99 3.8 CD-ROMS, DVDS, DISKETTEN UND WINDOWS-PARTITIONEN 100 3.8.1 AUTOMATISCHER ZUGRIFF AUF DATENTRGER UNTER KDE UND GNOME ... 101 3.8.2 MANUELLER ZUGRIFF AUF CD-ROMS 101 3.8.3 MANUELLER ZUGRIFF AUF DISKETTEN 102 3.8.4 MANUELLER ZUGRIFF AUF WINDOWS-PARTITIONEN 102 3.8.5 USB-, FIREWIRE- UND PCMCIA-LAUFWERKE, USB-MEMORY-STICKS .. 103 3.8.6 AKTUELLEN ZUSTAND DES DATEISYSTEMS ERMITTELN 104 3.8.7 /ETC/FSTAB - DATEISYSTEME AUTOMATISCH EINBINDEN 105 3.8.8 SPEZIELLE DATEISYSTEME 107 3.9 DOKUMENTATION ZU LINUX 109 3.9.1 HILFE IN GNOME- UND KDE-PROGRAMMEN 109 3.9.2 HILFE BEI TEXTORIENTIERTEN KOMMANDOS 109 3.9.3 MAN-HILFETEXTE 110 3.9.4 INFO-HILFETEXTE 111 3.9.5 ZUSATZDOKUMENTATION ZU PROGRAMMPAKETEN 112 3.9.6 DAS LINUX DOCUMENTATION PROJECT (LDP) 114 3.9.7 KERNEL-DOKUMENTATION 115 3.9.8 WEITERE DOKUMENTATIONEN IM INTERNET 115 KAPITEL 4 DIE LINUX-SHELL 117 4.1 AUFGABEN DER SHELL 118 4.2 GRUNDLEGENDE EIGENSCHAFTEN DER SHELL 119 4.3 EIN- UND AUSGABEUMLEITUNG 120 4.3.1 EINGABEUMLEITUNG 121 4.3.2 AUSGABEUMLEITUNG 121 4.3.3 PIPES 123 4.4 METAZEICHEN ZUR EXPANSION VON DATEINAMEN 124 4.5 STRING-ERSETZUNGEN (QUOTING) 126 4.6 BASH-SPEZIALITTEN 127 4.6.1 DER PROMPT 127</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">4.6.2 EDITIEREN DER KOMMANDOZEILE 128 4.6.3 HISTORY-MECHANISMUS 128 4.6.4 WICHTIGE INTERNE KOMMANDOS 128 4.6.5 ZEICHENKETTENBILDUNG MIT GESCHWEIFTEN KLAMMERN 129 4.6.6 BERECHNUNG ARITHMETISCHER AUSDRCKE IN ECKIGEN KLAMMERN 130 4.6.7 AUSGABEVERVIELFACHUNG MIT TEE 130 4.7 REGULRE AUSDRCKE, GREP UND SED 132 4.7.1 REGULRE AUSDRCKE (REGULR EXPRESSIONS) 132 4.7.2 GREP 135 4.7.3 DER STREAM-EDITOR SED 136 4.8 SHELL-PROGRAMMIERUNG 139 4.8.1 TESTEN VON SHELL-SKRIPTEN 140 4.8.2 KOMMENTARE IN SHELL-SKRIPTEN 141 4.8.3 SHELL-VARIABLE 142 4.8.4 VORDEFINIERTE VARIABLE 143 4.8.5 PARAMETERZUGRIFF IN SHELL-SKRIPTEN 145 4.8.6 NAMENS- UND PARAMETERERSETZUNG 147 4.8.7 BEARBEITUNG EINER BELIEBIGEN ANZAHL VON PARAMETERN 148 4.8.8 GLTIGKEIT VON KOMMANDOS UND VARIABLEN 148 4.8.9 INTERAKTIVE EINGABEN IN SHELL-SKRIPTEN 149 4.8.10 HIER-DOKUMENTE 150 4.8.11 VERKETTUNG VON KOMMANDOS 150 4.8.12 ZUSAMMENFASSUNG VON KOMMANDOS 151 4.8.13 STRUKTUREN DER SHELL 152 4.8.14 BEDINGUNGEN TESTEN 152 4.8.15 BEDINGTE ANWEISUNG (I F - THEN - EISE) 154 4.8.16 MEHRFACHAUSWAHL MIT CASE 157 4.8.17 DIE F OR-ANWEISUNG 158 4.8.18 ABWEISENDE WIEDERHOLUNGSANWEISUNG (WHI 1 E) 159 4.8.19 UNTI 1-ANWEISUNG 160 4.8.20 WEITERE ANWEISUNGEN 161 4.8.21 EXEC [KOMMANDOZEILE] 164 4.8.22 EVAL [ARGUMENTE] 165 4.8.23 TRAP ' KOMMANDO! I STE' SIGNALE 166 4.8.24 SHELL-FUNKTIONEN 167 4.8.25 XA RGS 169 4.8.26 FIND 170 4.9 BEISPIELE FR SHELL-SKRIPTEN 172 4.9.1 DATEI VERLNGERN 172 4.9.2 TELEFONBUCH 172 4.9.3 ARGUMENTE MIT J/N-ABFRAGE AUSFHREN 172 4.9.4 DATEIEN IM PFAD SUCHEN 173 4.9.5 BERECHNUNG DES OSTERDATUMS NACH C. F. GAUSS 173 4.9.6 WEM DIE STUNDE SCHLGT 175 4.9.7 EINGABE OHNE ENTER-TASTE 176 4.9.8 STNDIG KONTROLLIEREN, WER SICH EIN- UND AUSLOGGT 176 4.9.9 OPTIONEN ERMITTELN 176 4.9.10 RENAME-KOMMANDO 177 4.9.11 REKURSIVES SUCHEN IN DATEIEN 178 4.9.12 DAS LETZTE 179 4.10 REFERENZ SHELL-PROGRAMMIERUNG 179 4.11 REFERENZ ALLER SONDERZEICHEN 187 4.12 AUFGABEN 188 KAPITEL 5 WWW, E-MAIL, NFS, SSH UND SCP 191 5.1 WEBBROWSER 192</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">5.1.1 DIE MOZILLA-FAMILIE 192 5.1.2 KONQUEROR 196 5.1.3 LYNX 198 5.2 E-MAIL 199 5.2.1 GLOSSAR 199 5.2.2 MAIL-KONFIGURATION 200 5.2.3 MAILBOX-FORMATE UND -KONVERTIERUNG 202 5.3 E-MAIL-CLIENTS 203 5.3.1 MOZILLA UND THUNDERBIRD 203 5.3.2 KMAIL 206 5.4 ZUGRIFF AUF LINUX-VERZEICHNISSE IM NETZ (NFS) 209 5.4.1 NFS-CLIENT 209 5.4.2 NFS-SERVER 210 5.5 ZUGRIFF AUF WINDOWS-VERZEICHNISSEIM NETZ (SMB) 212 5.6 FTP-CLIENT 215 5.6.1 FTP-CLIENTS 215 5.6.2 FTP-KOMMANDO 216 5.7 SSH 217 5.7.1 SFTP (SECURE FTP) 220 5.8 VERZEICHNISSE KOPIEREN UND SYNCHRONISIEREN (RSYNC) 220 KAPITEL 6 DRUCKEN MIT CUPS 223 6.1 KONFIGURATION UND ANWENDUNG LOKALER DRUCKER 224 6.1.1 REDHAT- UND FEDORA-DRUCKER-KONFIGURATION 225 6.1.2 SUSE-DRUCKER-KONFIGURATION 226 6.1.3 KDE-DRUCKER-KONFIGURATION 226 6.1.4 DRUCKEN 227 6.2 INTERNA DES DRUCKPROZESSES 229 6.3 SPOOLING-SYSTEME (CUPS) 231 6.3.1 BSD-LPD 231 6.3.2 LPRNG 232 6.3.3 CUPS 232 6.3.4 CUPS-KOMMANDOS 235 6.3.5 CUPS-WEBADMINISTRATION 237 6.4 NETZWERKDRUCKER ANBIETEN (SERVER) 238 6.4.1 BSD-LPD-KOMPATIBILITT 240 6.5 NETZWERKDRUCKER NUTZEN (CLIENT) 241 6.6 POSTSCRIPT- UND PDF-TOOLS 242 6.6.1 POSTSCRIPT- UND PDF-VIEWER 242 6.6.2 KONVERTIERUNG TEXT - POSTSCRIPT 243 6.6.3 KONVERTIERUNG HTML -* POSTSCRIPT 244 6.6.4 KONVERTIERUNG PS + PDF 245 6.6.5 POSTSCRIPT-TOOLS (PSUTILS) 245 6.6.6 GHOSTSCRIPT, GIMP-PRINT UND ANDERE DRUCKERTREIBER 247 KAPITEL 7 AUDIO UND VIDEO 251 7.1 KONFIGURATION DER SOUNDKARTE 252 7.1.1 LAUTSTRKEREGELUNG 253 7.1.2 ERSTER TEST 254 7.1.3 SOUND-KERNEL-MODULE 254 7.1.4 ALSA-KONFIGURATION 254 7.1.5 DIE GSTREAMER-BIBLIOTHEK 256 7.1.6 KDE- UND GNOME-SOUNDSYSTEM 256 7.2 CD-PLAYER 257 7.3 AUDIO-TOOLS 258 7.3.1 MP3-FORMAT 259 7.3.2 OGG-VORBIS-FORMAT 261 7.3.3 AUDIO-PLAYER 261 7.3.4 REALPLAYER 262 7.3.5 AUDIO-KONVERTER 262 7.3.6 CD-TRACKS EINLESEN (RIPPER) 263 7.4 DVDS UND VIDEO-DATEIEN ANSEHEN 264 7.4.1 TIPPS ZUR INSTALLATION UND KONFIGURATION 264 7.4.2 XINE 265 7.4.3 MPLAYER 266 7.4.4 OGLE UND VIDEOLAN 267 7.4.5 CSS 267 7.4.6 TV-ANWENDUNGEN 268</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">7.5 DIGITALKAMERAS, SCANNER, BILDVERARBEITUNG 268 7.5.1 DIGIKAM (KDE) 269 7.5.2 GTKAM (GNOME) 270 7.5.3 GTHUMB (GNOME) 270 7.5.4 GPHOTO2 271 7.5.5 LESEGERTE FR SPEICHERKARTEN 271 7.5.6 SCANNER 271 7.5.7 SCREENSHOTS ERSTELLEN 274 7.5.8 BILDBETRACHTUNG UND -KONVERTIERUNG 275 7.6 CDS UND DVDS BRENNEN 277 7.6.1 CD- UND DVD-LAUFWERKE KORREKT KONFIGURIEREN 279 7.7 BENUTZEROBERFLCHEN 280 7.7.1 K3B (KDE) 280 7.7.2 NAUTILUS (GNOME) 283 7.7.3 BRENNER-TOOLS 284 KAPITEL 8 TEXTBEARBEITUNG MIT LAT^X UND LYX 295 8.1 EINFHRUNG 296 8.1.1 LATEX UND DIE WICHTIGSTEN HILFSPROGRAMME 297 8.1.2 FEHLERSUCHE IN LATGX-TEXTEN 299 8.1.3 EINFHRUNGSBEISPIEL 301 8.1.4 TETEX 303 8.2 ELEMENTARE LATEX-KOMMANDOS 305 8.2.1 FORMALE DETAILS 305 8.2.2 VORSPANN 306 8.2.3 MAANGABEN 308 8.2.4 STRUKTURIERUNG VON TEXTEN 309 8.2.5 GESTALTUNG DES SCHRIFTBILDS 310 8.2.6 SONDERZEICHEN 311 8.2.7 AKZENTE UND BESONDERE BUCHSTABEN 313 8.2.8 EURO-SYMBOL 313 8.2.9 TABULATOREN 314 8.2.10 TABELLEN 315 8.2.11 GLEITOBJEKTE 320 8.2.12 AUFZHLUNGEN 322 8.2.13 BOXEN UND RAHMEN 323 8.3 GESTALTUNG WISSENSCHAFTLICHER TEXTE 327 8.3.1 DIE TITELSEITE 327 8.3.2 BEARBEITUNG UMFANGREICHER TEXTE 328 8.3.3 INHALTSVERZEICHNIS 330 8.3.4 QUERVERWEISE 331 8.3.5 FUNOTEN 331 8.3.6 DER ANHANG 332 8.3.7 LITERATURVERZEICHNIS 332 8.3.8 STICHWORTVERZEICHNIS 333 8.4 ABBILDUNGEN 335 8.5 MATHEMATISCHE FORMELN 338 8.5.1 KLAMMERN 342 8.5.2 MATRIZEN 342 8.5.3 MATHEMATISCHE SONDERZEICHEN 343 8.5.4 GRIECHISCHE UND KALLIGRAFISCHE BUCHSTABEN 344 8.6 STEUERUNG DES LAYOUTS 344 8.6.1 TRENNUNGEN 344 8.6.2 WORTZWISCHENRUME UND HORIZONTALE LEERRUME 345 8.6.3 ZEILENUMBRUCH UND VERTIKALE LEERRUME 346 8.6.4 FESTER SEITENUMBRUCH 347 8.6.5 EIGENE KOPFZEILEN 347 8.6.6 GLOBALE LAYOUTEINSTELLUNG 348 8.7 BRIEFE SCHREIBEN 350 8.8 FARBEN 354 8.9 TEXTE ROTIEREN 357 8.10 FOLIEN UND PRSENTATIONEN ERSTELLEN 358 8.10.1 FOLIEN ERSTELLEN MIT SEMINAR 358 8.10.2 FOLIEN ERSTELLEN MIT BEAMER 361 8.11 LATX-MAKROS SCHREIBEN 368 8.12 LATEX-DOKUMENTE ANZEIGEN UND WEITERVERARBEITEN 373</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">8.12.1 DVI-DATEIEN ANZEIGEN (XDVI, KDVI) 373 8.12.2 POSTSCRIPT-DOKUMENTE ERZEUGEN (DVIPS) 374 8.12.3 PDF-DOKUMENTE ERZEUGEN 375 8.12.4 HTML-DOKUMENTE ERZEUGEN 377 8.13 METAFONT- UND POSTSCRIPT-SCHRIFTEN 377 8.13.1 METAFONT-SCHRIFTEN 377 8.13.2 POSTSCRIPT-SCHRIFTEN (TYPE-1-FONTS) 379 8.14 LYX - IATEX LEICHT GEMACHT 381 8.14.1 WAS IST LYX (UND WAS IST ES NICHT)? 382 8.14.2 LYX-DOKUMENTE ERSTELLEN, BEARBEITEN UND AUSDRUCKEN 383 8.14.3 TEXTFORMATIERUNG 384 8.14.4 BESONDERE TEXTELEMENTE (TABELLEN, FUNOTEN, FORMELN) 385 8.14.5 MATHEMATISCHE FORMELN 386 8.14.6 LYX-BESONDERHEITEN 388 8.15 AUFGABEN 388 KAPITEL 9 ANWENDUNGSPROGRAMME 391 9.1 HOME OFFICE 392 9.1.1 OPENOFFLCE 392 9.1.2 OPENOFFICE-ALTERNATIVEN 394 9.1.3 ABIWORD 395 9.1.4 DTP MIT SCRIBUS 397 9.1.5 SCITE-TEXTEDITOR 399 9.1.6 GLABELS: AUFKLEBER UND VISITENKARTEN 400 9.1.7 RECHTSCHREIBPRFUNG MIT ISPELL 400 9.1.8 TABELLENKALKULATION 401 9.2 MIND MAPPER 402 9.3 PROJEKTPLANUNG 404 9.3.1 PLANNER 404 9.3.2 TASKJUGGLER 404 9.4 GRAFIKPROGRAMME 405 9.4.1 GIMP - DIE PHOTOSHOP-ALTERNATIVE 405 9.4.2 GNUPLOT 409 9.4.3 LABPLOT 412 9.4.4 XFIG - DER VEKTORZEICHEN-KLASSIKER 413 9.4.5 VEKTORZEICHENPROGRAMM DIA 414 9.5 SYMBOLISCHE MATHEMATIK 415 9.5.1 EULER 415 9.5.2 MUPAD 419 9.6 CHEMIE UND BIOLOGIE 420 9.6.1 PERIODENSYSTEM DER ELEMENTE 420 9.6.2 GENTLE 422 9.7 ELEKTROTECHNIK 425 9.7.1 KRELAIS 425 9.7.2 KLOGIC 426 9.7.3 KTECHLAB 427 9.7.4 CHIPMUNK 428 9.7.5 FREEHDL 429 9.7.6 ELECTRIC 430 9.7.7 EAGLE 431 9.8 DATENBANKEN 433 9.8.1 DESKTOP-WIKI MIT ZIM 433 9.8.2 MYSQL 434 KAPITEL 10 PROGRAMMIERUNG 439 10.1 BIBLIOTHEKEN 440 10.2 PROGRAMME SELBST KOMPILIEREN 441 10.3 ENTWICKLUNGSUMGEBUNGEN 443 10.3.1 XWPE 444 10.3.2 C-FORGE 444 10.3.3 ANJUTA 444 10.3.4 KDEVELOP 445 10.3.5 KOMODO VON ACTIVESTATE 447 10.3.6 GEANY 448 10.3.7 ECLIPSE 449 10.3.8 GAMBAS 450 10.4 PROGRAMMIERUNG MIT PERL 451 10.4.1 HELLO WORLD 453 10.4.2 EIN PROGRAMM AUSFHREN 453 10.4.3 AUFRUF 454 10.4.4 SPRACHKONTEXT 454 10.4.5 VARIABLEN 455</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">10.4.6 OPERATIONEN UND ZUWEISUNGEN 458 10.4.7 KONTROLLSTRUKTUREN 466 10.4.8 REGULRE AUSDRCKE 469 10.4.9 UNTERPROGRAMME 474 10.4.10 DATEIEN 480 10.4.11 REFERENZEN 494 10.4.12 DER PERL-DEBUGGER 497 10.5 AUFGABEN 504 KAPITEL 11 BASISKONFIGURATION 507 11.1 KONFIGURATION DER TEXTKONSOLE 509 11.2 DATUM UND UHRZEIT 510 11.3 SPRACHEINSTELLUNG, INTERNATIONALISIERUNG, UNICODE 510 11.3.1 ZEICHENSTZE 510 11.3.2 LOKALISATION UND ZEICHENSATZ EINSTELLEN 512 11.4 BENUTZER- UND GRUPPENVERWALTUNG 513 11.4.1 BENUTZER 513 11.4.2 GRUPPEN 514 11.4.3 PASSWRTER 515 11.4.4 MANUELLE BENUTZER- UND GRUPPENVERWALTUNG 516 11.5 SYSTEMPROZESSE (DMONEN) 517 11.6 PROZESSE AUTOMATISCH STARTEN (CRONTAB) 518 11.7 DAS /PROC-VERZEICHNIS 519 11.8 SOFTWARE- UND PAKETVERWALTUNG 520 11.8.1 RPM (RPM PACKAGE MANAGER) 521 11.8.2 APT-RPM 524 11.8.3 DPKG UND APT (DEBIAN-PAKETVERWALTUNG) 526 11.8.4 TAR 529 11.9 SYSTEMSTART 529 11.9.1 GRUB 529 11.9.2 LILO 531 11.9.3 INIT-V-PROZESS 531 11.10 LOG-DATEIEN UND KERNEL-MELDUNGEN 537 KAPITEL 12 DAS X WINDOW-SYSTEM 539 12.1 MONITOR-HARDWARE 541 12.2 X STARTEN UND BEENDEN 542 12.3 KONFIGURATION DES X-SERVERS 543 12.3.1 MONITOR-ABSCHNITT 544 12.3.2 DEVICE-ABSCHNITT (GRAFIKKARTE) 545 12.3.3 SCREEN-ABSCHNITT (AUFLSUNG, FARBANZAHL) 545 12.3.4 GRAFIKMODUS SELBST DEFINIEREN 546 12.3.5 FILES-ABSCHNITT 548 12.3.6 MODULES-ABSCHNITT 548 12.3.7 SERVERFLAGS-ABSCHNITT 549 12.3.8 UMGANG MIT XFREE86-INKOMPATIBLEN GRAFIKKARTEN 549 12.3.9 VESA- UND FRAMEBUFFER-TREIBER 550 12.3.10 TASTATUR 551 12.3.11 XMODMAP, XEV, SETXKBMAP 552 12.3.12 MAUS 553 12.3.13 KONFIGURATION IN XF86CONFIG 553 12.4 X.ORG 555 12.5 SCHRIFTARTEN (FONTS) 555 12.6 X-START (WINDOW MANAGER) 556 12.6.1 XDM-KONFIGURATION 557 12.6.2 KDM-KONFIGURATION 557 12.6.3 GDM-KONFIGURATION 558 12.7 XTERM UND ANDERE X-UTILITIES 558 12.7.1 XTERM 558 12.7.2 XHOST 559 KAPITEL 13 LINUX IM LOKALEN NETZ 561 13.1 LOOPBACK, IP-ADRESSEN, NETZMASKE 562 13.2 KONFIGURATION VON NETZWERKKARTEN 565 13.2.1 NETZWERKKONFIGURATION 565</subfield>
+          </datafield>
+          <datafield tag="TXT" ind1=" " ind2=" ">
+            <subfield code="a">13.2.2 MANUELLE INBETRIEBNAHME EINER NETZWERKKARTE 566 13.2.3 KONFIGURATIONSDATEIEN UND -INTERNA 569 13.2.4 NETZWERKFUNKTIONEN TESTEN 571 ANHANG A LITERATUR 575 A.L LINUX UND UNIX 575 A.2 IMEX 575 A.3 ANWENDUNGSPROGRAMME 575 A.4 PROGRAMMIEREN IN C, C++ 576 A.5 PROGRAMMIEREN IN PERL 576 A.6 ADMINISTRATION UND NETZWERK 576 A.7 ALLGEMEINE INFORMATIONEN 577 ANHANG B DIE DVDS ZUM BUCH 579 ANHANG C LSUNGEN DER AUFGABEN 581 C.L SHELL (KAPITEL 4) 581 C.2 LATGX (KAPITEL 8) 584 C.3 PROGRAMMIEREN MIT PERL (KAPITEL 10) 588 SACHREGISTER 595</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="b">40</subfield>
+            <subfield code="d">TWR12765+4</subfield>
+            <subfield code="i">07/8116</subfield>
+            <subfield code="n">30</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-50</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="b">41</subfield>
+            <subfield code="d">TWR12765</subfield>
+            <subfield code="i">07/8112</subfield>
+            <subfield code="n">20</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-10</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="b">41</subfield>
+            <subfield code="d">TWR12765+1</subfield>
+            <subfield code="i">07/8113</subfield>
+            <subfield code="n">20</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-20</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="b">41</subfield>
+            <subfield code="d">TWR12765+2</subfield>
+            <subfield code="i">07/8114</subfield>
+            <subfield code="n">20</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-30</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="b">41</subfield>
+            <subfield code="d">TWR12765+3</subfield>
+            <subfield code="i">07/8115</subfield>
+            <subfield code="n">20</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-40</subfield>
+          </datafield>
+          <datafield tag="LOC" ind1=" " ind2=" ">
+            <subfield code="m">BOOK</subfield>
+            <subfield code="a">P0001</subfield>
+            <subfield code="i">07/8122</subfield>
+            <subfield code="n">40</subfield>
+            <subfield code="k">20070905</subfield>
+            <subfield code="5">987705-60</subfield>
+          </datafield>
+        </record>
+      </metadata>
+    </record>
+  </ListRecords>
+</OAI-PMH>

data/spec/document/aleph_mab_xml_document_factory_spec.rb

@@ -0,0 +1,37 @@
+describe Metacrunch::Mab2::AlephMabXmlDocumentFactory do
+
+  context "with default test xml file" do
+    let(:factory) { Metacrunch::Mab2::AlephMabXmlDocumentFactory.new(default_test_xml) }
+
+    describe ".to_document" do
+      subject { factory.to_document }
+
+      it "should return a Mab2::Document" do
+        expect(subject).to be_instance_of(Metacrunch::Mab2::Document)
+      end
+
+      it "should find 2 data fields with tag 070" do
+        expect(subject.datafields("070").count).to be(2)
+      end
+
+      it "should find 1 data field with tag 100" do
+        expect(subject.datafields("100").first).not_to be_nil
+      end
+
+      it "sub field p of data field 100 is not nil" do
+        expect(subject.datafields("100").first.subfields("p").first.value).not_to be_nil
+      end
+
+      it "decodes html entities" do
+        expect(subject.datafields("331").subfields("a").values.first).to eq("<<Das>> Linux für Studenten")
+      end
+    end
+  end
+
+private
+
+  def default_test_xml
+    File.read(File.join(RSpec.root, "assets", "aleph_mab_xml", "file1.xml"))
+  end
+
+end

data/spec/document/control_field_spec.rb

@@ -0,0 +1,51 @@
+describe Metacrunch::Mab2::Document::Controlfield do
+
+  describe ".initialize" do
+    it "creates a new control field when using String values" do
+      field = Metacrunch::Mab2::Document::Controlfield.new("050", "a||b")
+      expect(field.tag).to eq("050")
+      expect(field.values).to eq(["a", nil, nil, "b"])
+    end
+
+    it "creates a new control field when using Array values" do
+      field = Metacrunch::Mab2::Document::Controlfield.new("050", ["a", nil, nil, "b"])
+      expect(field.tag).to eq("050")
+      expect(field.values).to eq(["a", nil, nil, "b"])
+    end
+  end
+
+  describe ".values=" do
+    let(:field) { Metacrunch::Mab2::Document::Controlfield.new("050", nil) }
+
+    it "sets field values using String" do
+      field.values = "a||b"
+      expect(field.values).to eq(["a", nil, nil, "b"])
+    end
+
+    it "sets field values using Array" do
+      field.values = ["a", nil, nil, "b"]
+      expect(field.values).to eq(["a", nil, nil, "b"])
+    end
+
+    it "fails on arrays that contain elements longer than one char" do
+      expect{
+        field.values = ["a", "bc"]
+      }.to raise_error(ArgumentError)
+    end
+
+    it "converts array values into String" do
+      field.values = [8, nil]
+      expect(field.values).to eq(["8", nil])
+    end
+
+    it "converts empty string values for arrays into nil" do
+      field.values = ["", nil]
+      expect(field.values).to eq([nil, nil])
+    end
+
+    it "converts nil into empty array" do
+      field.values = nil
+      expect(field.values).to eq([])
+    end
+  end
+end

data/spec/document/document_spec.rb

@@ -0,0 +1,114 @@
+describe Metacrunch::Mab2::Document do
+
+  describe "#from_aleph_mab_xml" do
+    let(:xml) { default_test_xml }
+    let(:document) { Metacrunch::Mab2::Document.from_aleph_mab_xml(xml) }
+    subject { document }
+
+    it "should create a Document from Aleph MAB XML" do
+      expect(subject).to be_instance_of(Metacrunch::Mab2::Document)
+    end
+  end
+
+  describe ".add_controlfield" do
+    let(:document) { empty_document }
+
+    it "should add control fields" do
+      document.add_controlfield(create_controlfield("001", "a|a|"))
+      expect(document.controlfield("001").values).to eq(["a", nil, "a", nil])
+    end
+  end
+
+  describe ".controlfield" do
+    let(:document) { default_test_document }
+    subject { document.controlfield("050") }
+
+    it { is_expected.not_to be_nil }
+    it { is_expected.to be_instance_of(Metacrunch::Mab2::Document::Controlfield) }
+    it "should contain the correct values" do
+      expect(subject.values).to eq(["a", nil, "a", nil])
+    end
+  end
+
+  describe ".datafields" do
+    let(:document) { default_test_document }
+
+    context "given tag=100" do
+      subject { document.datafields("100") }
+
+      it "returns only datafields with tag=100" do
+        expect(subject.count).to eq(2)
+      end
+    end
+
+    context "given tag=100 and ind1=-" do
+      subject { document.datafields("100", ind1: "-") }
+
+      it "returns only datafields with tag=100 and ind1=-" do
+        expect(subject.count).to eq(1)
+      end
+    end
+
+    context "given tag=100 and ind2=2" do
+      subject { document.datafields("100", ind2: "2") }
+
+      it "returns only datafields with tag=100 and ind2=2" do
+        expect(subject.count).to eq(1)
+      end
+    end
+
+    context "given tag=100 and ind1=a and ind2=2" do
+      subject { document.datafields("100", ind2: "2") }
+
+      it "returns only datafields with tag=100 and ind1=a and ind2=2" do
+        expect(subject.count).to eq(1)
+      end
+    end
+  end
+
+private
+
+  def empty_document
+    Metacrunch::Mab2::Document.new
+  end
+
+  def default_test_document
+    document = Metacrunch::Mab2::Document.new
+    document.add_controlfield(create_controlfield("LDR", "01234"))
+    document.add_controlfield(create_controlfield("050", "a|a|"))
+    document.add_controlfield(create_controlfield("052", ["a", nil, "b"]))
+
+    datafield = create_datafield("100", ind1: "-", ind2: "1")
+    datafield.add_subfield(create_subfield("p", "Doe, John"))
+    datafield.add_subfield(create_subfield("9", "123456789"))
+    document.add_datafield(datafield)
+
+    datafield = create_datafield("100", ind1: "a", ind2: "2")
+    datafield.add_subfield(create_subfield("p", "Sprotte, René"))
+    datafield.add_subfield(create_subfield("9", "123456789"))
+    document.add_datafield(datafield)
+
+    datafield = create_datafield("331", ind1: "-", ind2: "1")
+    datafield.add_subfield(create_subfield("a", "<<The>> art of MAB processing"))
+    document.add_datafield(datafield)
+
+    document
+  end
+
+  def default_test_xml
+    File.read(File.join(RSpec.root, "assets", "aleph_mab_xml", "file1.xml"))
+  end
+
+  def create_controlfield(tag, values)
+    Metacrunch::Mab2::Document::Controlfield.new(tag, values)
+  end
+
+  def create_datafield(tag, ind1:nil, ind2:nil)
+    Metacrunch::Mab2::Document::Datafield.new(tag, ind1: ind1, ind2: ind2)
+  end
+
+  def create_subfield(code, value)
+    Metacrunch::Mab2::Document::Datafield::Subfield.new(code, value)
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require "metacrunch/mab2"
+
+RSpec.configure do |config|
+end
+
+# Helper to provide RSpec.root
+module ::RSpec
+  module_function
+  def root
+    @spec_root ||= Pathname.new(__dir__)
+  end
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: metacrunch-mab2
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- René Sprotte
+- Michael Sievers
+- Marcel Otto
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: metacrunch
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: htmlentities
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+- !ruby/object:Gem::Dependency
+  name: ox
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description: MAB2 tools for metacrunch
+email: r.sprotte@ub.uni-paderborn.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- License.txt
+- Rakefile
+- Readme.md
+- benchmarks/mab2_document_parsing.rb
+- benchmarks/mab2_document_query.rb
+- lib/metacrunch/mab2.rb
+- lib/metacrunch/mab2/aleph_mab_xml_document_factory.rb
+- lib/metacrunch/mab2/cli.rb
+- lib/metacrunch/mab2/document.rb
+- lib/metacrunch/mab2/document/controlfield.rb
+- lib/metacrunch/mab2/document/datafield.rb
+- lib/metacrunch/mab2/document/datafield_set.rb
+- lib/metacrunch/mab2/document/subfield.rb
+- lib/metacrunch/mab2/document/subfield_set.rb
+- lib/metacrunch/mab2/version.rb
+- lib/metacrunch_plugin.rb
+- metacrunch-mab2.gemspec
+- spec/assets/aleph_mab_xml/file1.xml
+- spec/document/aleph_mab_xml_document_factory_spec.rb
+- spec/document/control_field_spec.rb
+- spec/document/document_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/ubpb/metacrunch-mab2
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: MAB2 tools for metacrunch
+test_files:
+- spec/assets/aleph_mab_xml/file1.xml
+- spec/document/aleph_mab_xml_document_factory_spec.rb
+- spec/document/control_field_spec.rb
+- spec/document/document_spec.rb
+- spec/spec_helper.rb
+has_rdoc: